Shareware Super Platinum 8/Shareware Super Platinum 8.iso/mac/MODEMPRO/TT20.ZIP;1/TT2.DOC

Text File | 1991-09-01 | 148.7 KB | 4,245 lines

                                 TurboTerm 2.0

                           Program Reference Manual

            (c) Copyright 1991 by Brian Dunworth and Scott Riether





         To register your copy of TurboTerm, please fill out this form, and
         send it to the address listed.



  Submit To: Scott Riether
             TurboTerm Registrations
             19 Summit Road
             Stratford, NJ. 08084



  Qty. Description                                        Amount

  ____ TurboTerm Registration                           $25.00 ea __________

  ____ TurboTerm Registration & Printed Manual          $40.00 ea __________


                                                         Shipping __________


                                                            Total __________

  Name:_____________________________________________

  Company:__________________________________________

  Address:__________________________________________

  City:___________________________State:____Zip:__________

  Work Phone: (____)  ________________     Home Phone: (____) _______________

  Comments: _________________________________________________________________

            _________________________________________________________________

            _________________________________________________________________

            _________________________________________________________________

            _________________________________________________________________

            _________________________________________________________________

            _________________________________________________________________

            _________________________________________________________________

  Note: Shipping to 48 continental states is $5.00.  Shipping to Alaska,
        Hawaii, and Canada is $10.00.



  Registered TurboTerm users will receive a copy of TurboTerm 2.0 which no
  longer displays the registration notice.

                      Please allow 3-5 weeks for delivery.







                               Table Of Contents








     1. Installation ................................................... 1

     2. Command Line Parameters ........................................ 3

     3. The TurboTerm Status Line ...................................... 4

     4. TTSetup ........................................................ 5

     5. -  Video Options ............................................... 6

     6. -  Modem Options ............................................... 7

     7. -  Directories ................................................ 13

     8. -  User Shells ................................................ 14

     9. -  Protocols .................................................. 16

    10. -  Miscellaneous Options ...................................... 23

    11. Program Reference ............................................. 34

    12. Appendix A  -  Setting Up a Ram Disk .......................... 46

    13. Appendix B  -  Usage Logs ..................................... 48

    14. Appendix C  -  Script Commands ................................ 50

    15. Appendix D  -  TurboTerm Clipboard ............................ 55





 TurboTerm 2.0                    Installation



                       Don't forget to make backups.


    Floppy disk installation:

    Be aware that TurboTerm requires one of the following drive setups:

      A -  Two 360K floppy drives

         Although TurboTerm can be run from two 360K floppy drives, the
         installation process gets somewhat involved.

         If you have only two 360K floppy drives then follow these
         instructions:

            1 - Place TTSETUP.EXE, and TT.EXE on diskettes by themselves.

            2 - Run TTSetup using the instructions found later in this
                manual.

            3 - After entering all the setup defaults that you wish for
                TurboTerm, copy the TT.CFG file from your setup diskette
                onto the diskette which contains TT.EXE

            4 - TT.EXE and TT.CFG are the only files required for
                TurboTerm to operate correctly.  Any other files that it
                needs, it will create.

         Remember:  The disk containing TT.EXE must never be removed from
                    the disk drive during the operation of the program.

      B - A single 720K floppy

         TurboTerm and its associated files take approximately 500K of
         disk space, so a single 720K diskette should be fine for most
         installations.  Place all .EXE files from your original archive
         onto a formatted 720K diskette.  Log onto that drive and type
         TTSETUP<ENTER> at the DOS prompt.  Configure TurboTerm for your
         system using the instructions found later in this manual.

         Remember:  The disk containing TT.EXE must never be removed from
                    the  disk drive during the operation of the program.

      C - A hard disk with at least 500k free.

    Disk swapping (discussed later in this manual) is not available for
    floppy only installations.










 09-01-91                                 1



 TurboTerm 2.0                    Installation

    Hard Disk Installation:

    When installing TurboTerm on a hard disk, all files from the original
    archives should be copied into the \TT subdirectory.  After the files
    have been copied into your \TT directory, change to your TurboTerm
    directory by typing CD\TT<Enter>.  At the DOS prompt type TTSETUP
    <Enter>.  Configure TurboTerm for your system using the instructions
    found later in this manual.

    To make your TurboTerm directory as uncluttered as possible, it is
    recommended that you separate your upload, download, script, and log
    directories.  TurboTerm defaults to having all files located in your
    TurboTerm directory.  It would be worth your time, however, to change
    your default directories to help organize your TurboTerm setup.  Here
    is a picture of one possible TurboTerm subdirectory setup on a hard
    disk:

         TTƒ¬ƒƒTRANS
            √ƒƒSCRIPTS
            ¿ƒƒLOGS

    The TT\TRANS directory is used to store all uploaded and downloaded
    files.  A separate directory is optional, but having it will make file
    location easier.

    The TT\SCRIPTS directory is a convenient place to store all of your
    TurboTerm script files, to facilitate script maintenance.  You can
    recognize a TurboTerm script file from its extension.  All files
    ending in .SCR are script files.  The sample scripts and the
    documentation found later in this manual should help you in
    customizing a script for your own needs.  Copy the provided TurboTerm
    scripts to the directory you set up as your script directory.

    The TT\LOGS directory is where all of TurboTerm's capture and usage
    logs will be stored.  TurboTerm's logs and capture logs will be
    discussed later in this manual.























                                          2                          09-01-91



 TurboTerm 2.0              Command Line Parameters


    Certain TurboTerm features are (out of necessity) implemented via
    command line parameters and have no terminal mode or script command
    equivalents.  Command line parameters are not case sensitive and may
    be specified in any order.

    The following DOS command-line parameters are valid when starting
    TurboTerm:

            @0     Tells TurboTerm to start up in the dialing directory,
                   waiting for user input.  Under most conditions you
                   would first be entering TurboTerm to dial a number
                   anyway, so this gives you the ability to enter the
                   dialing directory quickly without typing <Alt-D>.

            @#     Tells TurboTerm to dial the specified entry in the
                   dialing directory.  This enables TurboTerm to be run
                   from a batch file as part of some maintenance
                   procedure, or as a quick way to start dialing your
                   favorite number upon invoking TurboTerm.

      -MR or /MR   Force TurboTerm to send your predefined modem
                   initialization sequence regardless of whether
                   TurboTerm detects a carrier.  This is useful when you
                   have modem setup to maintain DTR high even when not
                   online.

      -CD or /CD   Absolutely, positively do not send the modem
                   initialization string when entering TurboTerm.






























 09-01-91                                 3



 TurboTerm 2.0                    Status Line


    TurboTerm displays many of its operational parameters on the status
    line on the bottom of the screen.  The status line is divided into the
    following areas:

    TurboTerm!   This is the program name, and a proud addition to any
                 status line.  This is overwritten (temporarily) when
                 <Alt-T> is pressed to display the current date and time,
                 and during clipboard transfers, when the transfer status
                 is indicated.  At the conclusion of either of these
                 events, the program name is again displayed.

    Emulation    This is the current Terminal emulation.  Available
                 emulations are:

                   TTY
                   ANSI
                   DEBUG_ASCII
                   DEBUG_HEX

                 Terminal emulation is discussed later in this manual.

    Alt-Z        This is always displayed for those that can never
                 remember that keystroke.  Pressing <Alt-Z> while inside
                 TurboTerm will pop up a full screen listing of the
                 most-common TurboTerm commands.

    Com params   This area displays your current com port, duplex, parity,
                 data bits, stop bits, and baud rate.  These settings are
                 discussed later in this manual.

    Off-line     This area displays the on-line status.  It will display
                 Online/Offline/Direct based on the status of the modem
                 DTR signal, or the status of the null modem toggle.

    Log          This is the status of your capture log file.  If the word
                 LOG is visible, the current session is being logged to
                 disk.

    Time         This area displays the current time when off-line, or the
                 elapsed time since connection was established.  As soon
                 as the connection is terminated, the time display will
                 switch back to the current system time.
















                                          4                          09-01-91



 TurboTerm 2.0                      TTSetup


    TTSetup is a stand-alone program, and can be run from the DOS prompt
    by typing: TTSETUP <ENTER>

    You must run TTSetup at least once when you first run TurboTerm, as it
    creates a file containing all the user-defined features of TurboTerm.
    When you run TTSetup and save your settings upon exiting, a TT.CFG
    file will be created, containing your preferred TurboTerm settings.

      NOTE: If this is an upgrade from a previous release, TurboTerm will
            read the existing TT.CFG,  and will NOT create a new file upon
            startup.

    Configuring TurboTerm is simple, whether you are installing TurboTerm
    for the first time or upgrading from a previous release.

    When you first enter TTSetup, you are shown a menu that depicts each
    of the user-defined options.  TTSetup uses pull down menus for ease in
    selection and navigation.  With a little practice, you will find
    navigating through TTSetup extremely simple.  Use the cursor control
    keys to move to a particular item, and <ENTER> to select that item.

      TIP 1:  The highlighted letter in each menu choice is a hot key to
              that particular item, and can speed up your menu selections.

      TIP 2:  The escape key is used to exit you from any given field or
              menu item.

    In the paragraphs that follow, as each section of TTSetup is
    discussed, the paragraph heading will indicate TurboTerm's default
    selection in the section heading, surrounded by brackets ([]).




























 09-01-91                                 5



 TurboTerm 2.0                      TTSetup                             Video


    This section allows you to choose how TurboTerm will look on the
    screen.  You will be given the choice of 6 pre-defined color schemes,
    or you may customize TurboTerm's colors according to your own tastes.

    In most cases, TurboTerm will automatically detect the presence of a
    color monitor and chose whether you should use color or monochrome
    color sets.

    The custom color selection allows you to change numerous colors inside
    TurboTerm.  The names of the different dialog-, command-, and
    information-screens are displayed on the screen.  Simply choose the
    color you wish to change, and press <Enter>.

    After selecting the color to be changed, you will be given a sample
    TurboTerm screen on the right, and a color selection box on the left.
    The sample TurboTerm screen will magically update and give you an
    example of your changes, before you actually save your selections and
    return to TurboTerm.

    Standard cursor movement keys will allow you to pick your desired
    color for the selected option.  Upon moving the cursor, you will see a
    sample of the new color selection appear in the sample TurboTerm
    screen on the right.  Once you have selected the color that suits your
    taste, hitting <ENTER> will make that change take effect.  If you
    don't wish to make a change for the current color, then <ESC> will
    exit and automatically undo any change for that color.  At this point
    it might be prudent to state that even after you have selected the
    *perfect* color scheme, you must still save the changes when you exit
    TTSetup for the colors to effect the appearance of your TurboTerm
    screens.

    You have the ability to pick one of six predefined color sets inside
    TTSetup.  These color sets were designed to present a color scheme
    that is as pleasant and functional as possible.  Once you have
    selected a given color set you may still elect to change one or more
    of the colors to fully customize your TurboTerm colors.

    The blue color set is the default set for all systems that indicate
    a color monitor.  The red color set provides a bold, bright feeling,
    while the cyan color set gives a warmer, more mellow telecommunicating
    atmosphere.

    The monochrome color set is best suited for LCD laptops or monochrome
    systems.  This color set is chosen by default on systems that indicate
    a monochrome adapter.

    The random color set is provided for those that have a certain
    amount of difficulty in making up their mind.  For a truly
    distinctive color scheme, give the random color set a try.

    The direct video option is a toggle which will attempt to thwart the
    screen flicker found on some older CGA adapters, as well as allowing
    smoother screen output while running under multi-tasking environments
    such as DESQview or Windows 3.0.  TurboTerm defaults to using direct
    screen writes, providing much quicker screen output.



                                          6                          09-01-91



 TurboTerm 2.0                      TTSetup                             Modem


    This section is used to set the modem and hardware information
    particular to your setup, so that TurboTerm can operate correctly.


    Baud rate   [2400]

    This option allows you to pick a default baud rate for TurboTerm to
    initialize your modem at, and to initially configure your dialing
    directory entries.  While inside TurboTerm you can also change your
    baud rate with the <Alt-P> communications parameter settings function.
    The baud rate is the rate at which your computer will talk to your
    modem or serial port.  Typically you will choose the fastest rate that
    your modem is capable of. I.E.: If you have a 1200 baud modem, then
    choose 1200, or choose 2400 if you have a 2400 baud modem, etc. The
    only exception to this rule is for those people that have error
    correcting modems with MNP 1-5 or V.42.  With these modems it is
    typically desired to have a baud rate faster than the actual connect
    rate.

    For 2400 Bps MNP or V.42 modems you should set your baud at 4800 and
    for 9600 Bps MNP or V.42 modems you should select your baud rate at
    19200 (38400 for the newer/faster 9600 modems). If you are unsure of
    what rate your modem is capable of handling or which baud rate to
    choose, consult your modem instruction manual.

    This option can be defined while in TurboTerm with the <Alt-P>
    selection, and is also definable by dialing directory entry.  If you
    are calling a 1200 Bps system with your 2400 Bps modem, TurboTerm will
    automatically set the baud rate to the correct value when dialing that
    entry.


    Parity   [None]

    Parity is a bit to check the integrity of a received byte.  When used,
    all the bits in a data stream byte are added together.  A final bit,
    called the parity bit, is added such that the sum of all bits will be
    made either odd or even.  The transmitter calculates a parity bit, and
    transmits it with its data stream.  The receiver also calculates a
    party bit and compares it to the parity bit it received.  If the bits
    are equal, then no error has occurred, otherwise some error has
    occurred during transmission.

    The allowable parity settings are:

          No parity    - no parity bit is added.
          Even parity  - a parity bit is added so the sum bit is always
                         even.
          Odd Parity   - a parity bit is added so the sum bit is always
                         odd.
          Mark parity  - a parity bit of value one is always added.
          Space parity - a parity bit of value zero is always added.






 09-01-91                                 7



 TurboTerm 2.0                      TTSetup                             Modem

    Set your parity to None or Even for most applications. It should be
    mentioned that both GEnie and Compuserve allow parity settings of
    EVEN and NONE.  If your only use for TurboTerm is to call pay services
    such as GEnie or Compuserve, set even parity.  If your primary use for
    TurboTerm is to call bulletin board systems, set your parity to none.


    Data Bits   [8]

    Data bits are the number of bits of information in a data stream that
    is actual data and not parity or stop bit information.  Allowable data
    bit values are 5 through 8.  Under typical applications you should set
    your data bits to 8 when your parity is none, or to 7 when your parity
    is even.


    Stop bits   [1]

    Stop bits are the number of bits that indicate a complete transfer of
    all data bits in a serial data stream.  Typically your stop bit value
    should be selected to 1 for almost all applications.  Allowed values
    for stop bits are 1 and 2.


    Serial Port   [COM1]

    This is the serial port number designator that your modem or null
    modem is connected to.  Allowed values are COM1 through COM8.  The
    industry standard support for COM1 through COM4 is already configured
    inside TurboTerm, however some serial ports may not conform to the
    industry standards for these ports, so the ability to configure
    TurboTerm for non-standard serial ports is provided in TTSetup.
    Configuring TurboTerm for operation on a non-standard serial port is
    discussed under Port Assignments.


    Enable 16550A FIFO   [No]

    If you know you have a 16550A UART in your computer, it is highly
    recommended that you enable it.  This will insure fewer errors when
    connected at high data rates.  Enabling this feature in TurboTerm will
    cause no adverse effects if you do not have a 16550A UART.  Chances
    are, if you haven't personally purchased a 16550A UART for your
    computer, you do not have one.

    A FIFO is a First-In, First-Out buffer found only in the 16550A UART.
    The FIFO buffer in a 16550A UART allows a greater delay between each
    successive poll of a serial link without the chance for loss of data.
    A 16 byte buffer in the UART itself accomplishes this.

    Under normal circumstances this feature is not needed, however when
    using TurboTerm at high connect rates with a high speed modem or a
    null modem cable, loss of data can occur if the computer is doing
    something else when the next piece of information comes across the
    serial link.




                                          8                          09-01-91



 TurboTerm 2.0                      TTSetup                             Modem

    QEMM/386Max users should note that the memory/processor management
    schemes of these programs cause a slightly longer delay in serial port
    handling than computers that don't run them.  If you plan on running
    TurboTerm at any rate greater than 9600 baud and you are running one
    of these memory managers, then a 16550A UART is highly recommended.


    Flow Control    [Hardware CTS/RTS]

    Flow control is the means through which your computer requests a
    temporary pause in data transfer.  Typically such requests are
    required when data is being transferred faster than the receiver can
    process it.  Allowable flow control values are:

          None     - No flow control will be used for send or receive
                     operations.  This mode is not recommended unless
                     using TurboTerm for specific applications or other
                     specialized tasks.

         Software  - Software flow control uses the industry standard
                     [XOFF] and [XON] characters to tell a remote system
                     to pause and then resume data transfer.  Some modems
                     are incapable of the more reliable hardware flow
                     control, and in these cases you should select
                     software flow control.

                     NOTE: Some binary file transfers require that
                           hardware flow control be used, and will not
                           work with software flow control.  ZModem and
                           Kermit are capable of using either software or
                           hardware flow control.

         Hardware  - Hardware flow control is the most efficient means of
                     controlling the flow of data to and from your serial
                     port.  Hardware flow control follows the state of the
                     UART CTS/RTS lines.  In almost all instances,
                     hardware flow control should be enabled if possible.

                     NOTE: Some modems, specifically those found in Tandy
                           laptops, may not communicate with TurboTerm at
                           all when this option is turned on.  If you have
                           a Tandy laptop and cannot seem to get TurboTerm
                           to talk to the modem, then choose another form
                           of flow control.

         Both      - If you are unsure of what type of flow control to use
                     for a given application, choose this option to enable
                     both software and hardware flow control.  If your
                     hardware supports both hardware and software flow
                     control, then choosing this option will cause a
                     slight degradation in the throughput of binary file
                     transfers.







 09-01-91                                 9



 TurboTerm 2.0                      TTSetup                             Modem

    Port Assignments

    This option will allow you to configure TurboTerm to operate on a
    non-standard serial port.  If your serial port does not conform to the
    industry standard COM1 through COM4 designations, or your serial port
    is on COM5 through COM8, read on.

    Configuring a non-standard port for use with TurboTerm was made as
    simple as possible.  For TurboTerm to correctly interface with your
    serial port it must know the UART's base address, IRQ line, and
    interrupt number.


    Base Address   [Based on comport]

    The UART's base address is the hexadecimal number that represents the
    address of the UART in the PC's I/O address space.  In the IBM PC, the
    UART generally used is the 8250 or one of its descendants. The 8250
    UART family consists of the 8250, 16450, 16550, and the 16550A.
    TurboTerm is capable of correctly addressing all of these UARTs.  The
    8250 UART family can be likened to the 8088/8086 family of processors
    from Intel.  The 8250 was the first, and the 16550A is the latest.
    The 16650A's main advantage over its predecessors is it's internal
    FIFO buffer.  (For more information on FIFO buffering, and how to
    enable the 16550A FIFO buffer, see the information on 16550A FIFOs
    above.)

    To adjust the comport base address, press <ENTER> on Base Address,
    then select the comport base address that you wish to modify, and
    press <ENTER>.  Type in the hexadecimal number that represents the
    base address of your UART.  Valid numbers are from 0000 to FFFF


    IRQ line   [Based on comport]

    The IRQ number is the interrupt request line that is associated with a
    given UART.  When the UART receives a character it generates an
    interrupt request on the interrupt request line of the PC.

    To adjust the comport IRQ line press <ENTER> on IRQ line, then select
    the comport's IRQ that you wish to modify and press <ENTER>.  Type in
    the hexadecimal number of the IRQ line your serial port requires.
    Valid IRQ's are from 0 to F.


    Interrupt vector   [Based on comport]

    The interrupt vector is the associated interrupt service routine that
    handles the interrupt request when called for by the UART.

    To adjust the comport interrupt vector IRQ line press <ENTER> on
    Interrupt vector, then select the comport interrupt vector that you
    wish to modify, and press <ENTER>.  Type in the hexadecimal number of
    the interrupt vector your serial port requires.  Valid interrupt
    vectors are from 00 to FF.




                                         10                          09-01-91



 TurboTerm 2.0                      TTSetup                             Modem

    Under normal circumstance you should never have to adjust any of the
    values discussed above; the default values should work on most
    computers.

       PS/2 computer owners:

       When you are running on an IBM PS/2 it is imperative that you
       choose the Restore PS/2 Defaults option.  This will initialize
       TurboTerm to correctly locate and address your serial port.
       Failing to do this will prevent TurboTerm from running on any modem
       connected to any port other than COM1 or COM2.


    Modem commands

    The modem commands section allows you to configure TurboTerm to
    properly initialize, dial, and hang-up your modem.  The default
    configuration in TTSetup will work for most modems.  The ability to
    configure TurboTerm to your modem's specific commands is described
    below.  TurboTerm defaults to using the Hayes AT command set.


    Initialization string   [ATZ]

    Your modem initialization string determines the state that your modem
    will be in when first entering TurboTerm.  TurboTerm will send this
    string to your modem on program startup, unless specifically
    prohibited from doing so because of a sensed carrier or command line
    option.  The initialization string can be any valid string, your
    modem should be configured so that it reflects the true state of the
    carrier.  The Hayes command to accomplish this is AT&C1&D2.  Refer to
    your modem's manual for instructions on how to force your modem to
    follow the state of carrier detect.  For TurboTerm to work properly,
    your modem must be capable of following the true state of the carrier.
    One sure-fire way of determining if your modem has forced carrier
    presence is to check the Online/Offline area of the status bar.  If
    the status line indicates that you are 'Online' when you first enter
    TurboTerm, then you must reconfigure your modem.  Most modems allow
    you to accomplish this via switches or command line sequences.  When
    your modem is properly configured, TurboTerm will indicate 'Offline'
    when you initially enter the program.  If your modem does not have
    switches, or does not have non-volatile ram in which to save your
    configuration, then refer to the command line parameter section of
    this manual for further instructions.


    Dialing prefix   [ATDT]

    The dialing prefix is the command that will precede all phone numbers
    that TurboTerm dials.  In the Hayes AT command set, valid dialing
    prefixes are ATDT and ATDP.  The dialing prefix can, optionally, also
    contain commands to turn off call waiting, send your long distance
    calling card number, etc.  Under most circumstances, your dialing
    prefix will be either ATDT or ATDP.





 09-01-91                                11



 TurboTerm 2.0                      TTSetup                             Modem

    CONNECT message   [CONNECT]

    This string defines the message returned by your modem when it
    successfully connects to a remote modem.


    Modem ERROR messages    [Hayes Smartmodem]

    These strings define the message(s) that your modem will return upon
    failure to connect to a remote modem.  You should set these error
    messages to the responses that your modem will return, in order to
    help speed the redialing process.


    Hang-up command    [ATH0]

    This string defines the command your modem requires to force a
    disconnect.  The Hayes default is ATH0.


    Attention character    [43]  (+)

    This is the ASCII value of the character that your modem recognizes as
    its attention character.  Typically your attention character is a '+',
    ASCII value 43.


    DTR toggle

    This toggle sets whether TurboTerm will send your defined hang-up
    string to hang-up the modem, or lower the DTR on your modem.  The most
    reliable method of hanging up your modem is to lower DTR.



























                                         12                          09-01-91



 TurboTerm 2.0                      TTSetup                       Directories



    Upload directory    [TurboTerm directory]

    This is the directory where TurboTerm will initially look for all
    files that you wish to send to another system.


    Download Directory    [TurboTerm directory]

    This is the path where TurboTerm will place all files that you receive
    from another system during a file transfer.


    Script Directory    [TurboTerm directory]

    This is the path where TurboTerm will look for all script files.
    Scripts and the TurboTerm script language are discussed in Appendix C.


    Log Directory    [TurboTerm directory]

    This is the path where TurboTerm will write all its session capture
    logs and usage logs.

    It is recommended that you establish separate subdirectories when
    running TurboTerm from a hard drive to make file management easier.
    Don't worry about creating the subdirectories yourself;  TurboTerm
    will attempt to create the specified directory if it does not already
    exist.  If TurboTerm is unable to create the directory you specify, it
    will default to the TurboTerm program directory for that option.




























 09-01-91                                13



 TurboTerm 2.0                      TTSetup                       User Shells


    Have you ever wanted to go take a quick look at a file, without having
    to exit your terminal session?  With a defined user shell, it is
    possible to quickly pass control of your computer to a user defined
    program.  User shells in TurboTerm are specialized programs that can
    do anything from viewing files to running a spreadsheet.  You may
    define up to 10 user shells for use from within TurboTerm.  To
    activate any given shell, type Alt-0 through 9.  A valid shell is any
    existing DOS .EXE, .COM or .BAT file.


    The name    [Empty]

    This is where you will type in the full path and filename for the
    program.  Example:

           Alt 1 shell [C:\UTILS\LIST.COM C:\TT\TT.LOG        ]

    When inside TurboTerm, the Alt-1 shell would then shell to the program
    LIST.COM, and automatically list the file TT.LOG in your TurboTerm
    subdirectory.  Notice that a parameter may be passed to the program by
    typing the parameter in the entry space after the file name.

    NOTE: If you place a parameter on the command line after the filename,
          TurboTerm will not prompt you for any parameters when executing
          that shell.  If no parameters are specified in TTSetup, then
          TurboTerm will prompt you for the parameter(s) prior to
          executing the shell.



    Prompt    [No]

    After editing the filename and path of a given user shell, TTSetup
    will prompt you for a 'Y' or 'N'.  Selecting 'Yes' will force
    TurboTerm to prompt you with a 'Press any key to return to
    TurboTerm..' prompt prior to clearing the screen and returning to your
    telecommunications session.  Numerous programs run and execute so
    quickly that you are unable to see the result on the screen prior to
    returning to TurboTerm.  This is very common, especially in batch
    files.  To force a 'Press any key to return to TurboTerm...' prompt
    for a given user shell, set this field to 'Yes'.

    NOTE: TurboTerm will not change to the directory specified in the path
          stated on the command line.  If the called program requires that
          it be run from its own subdirectory, then we recommended you
          write a small DOS batch file to handle the directory changes.












                                         14                          09-01-91



 TurboTerm 2.0                      TTSetup                       User Shells

      Example:

      Lets say the program you want to run is SpeedWord, and it is located
      in your C:\SW\ subdirectory, and your TurboTerm directory is C:\TT\
      Since SpeedWord must be run from its own directory, you should set
      your shell to be: C:\SW\SW2.BAT COM2 PARITY EVEN

      You should then write a small batch file that looks something like
      this, and place it in your SpeedWord subdirectory.

           @ECHO OFF
           CD \SW
           SW %1 %2 %3 %4
           CD \TT
           EXIT

      This batch file will turn local echoing of the following commands
      off, then change to the SpeedWord subdirectory.  It then starts
      SpeedWord with the parameters you specified in your user shell.
      After completing SpeedWord, you will be returned to TurboTerm.







































 09-01-91                                15



 TurboTerm 2.0                      TTSetup                         Protocols


    The greatest improvement in TurboTerm 2.0 was the addition of internal
    file transfer protocols.  File transfer protocols are used for sending
    and receiving data files, usually in a non-readable or binary format.
    TurboTerm supports 9 internal protocols including: Xmodem, Xmodem CRC,
    Xmodem 1K, Xmodem 1KG, Ymodem, Ymodem G, Zmodem, Kermit, and ASCII.
    TurboTerm also supports 3 external protocols that are completely
    user-definable, with separate upload and download parameters.

    All of the protocol options have pre-defined defaults that conform to
    standard usage, making a change unnecessary in most situations.  Each
    prompt will be discussed in the following paragraphs.


    Default Protocol    [Zmodem]

    Your default protocol is the protocol you are most likely to use for a
    given file transfer.  Setting this protocol will not force you to use
    that protocol while in TurboTerm, but will allow quicker file
    transfers since the protocol will be highlighted in TurboTerm's
    selection menu when you initiate a transfer.  Simply pressing <ENTER>
    will initiate the transfer using the selected protocol.  Selecting a
    default protocol here is not the only place where default protocols
    may be picked.  Inside TurboTerm, each dialing directory entry may
    also have its own pre-defined default protocol.


    Send Directories    [No]

    This option is used when performing very specific file update requests
    to a given system.  Under normal circumstances you should leave this
    option off.  Send Directories instructs TurboTerm to send the complete
    path and filename in Ymodem, Zmodem, and Kermit file uploads.  This
    option would be used if you were performing an update of someone
    else's system remotely, and your subdirectory structure was the same
    as that on the remote system.  Again, using this feature would only be
    used when you wished to send the complete filename and path of the
    file you are sending.  If this option is turned off, TurboTerm will
    only send the filename.


    Honor Directories    [No]

    This option is used in conjunction with Send Directories.  If this
    option is enabled, it instructs TurboTerm to place the file in the
    subdirectory that the remote system sends along with the filename.
    When this option is enabled and the pathname that the remote system
    sends with the file does not exist, the file transfer will be aborted.
    This option should never be enabled unless your are downloading files
    from a specific system with a specific task in mind.

       WARNING: DO NOT ENABLE THIS OPTION UNLESS YOU ARE SURE OF YOUR FILE
                SOURCE, AND FULLY UNDERSTAND ITS CONSEQUENCES.






                                         16                          09-01-91



 TurboTerm 2.0                      TTSetup                         Protocols

    Download prompt    [Yes]

    When using batch transfers, it is sometimes desirable to have the
    files written to a subdirectory other than your default directory.
    When this feature is enabled, you will be prompted for the download
    path for all batch transfers (Zmodem, Ymodem, and Kermit).  Disabling
    this feature will bypass the prompt for batch file transfers, and
    place all downloaded files in your default download subdirectory.


    ASCII line pace    [10]

    The ASCII line pace is the number of milliseconds TurboTerm will pause
    between lines during ASCII transfers.  The line pace affects uploading
    using ASCII file transfers and TurboTerm Clipboard transfers.  Adjust
    this value if the remote system is unable to process a new line at the
    current rate.  Valid range is from 0 to 9999 msec.


    ASCII Character pace    [5]

    The ASCII character pace is the number of milliseconds TurboTerm will
    pause between characters during ASCII transfers. The character pace
    affects uploading using ASCII file transfers and TurboTerm Clipboard
    transfers.  Adjust this value if the remote system is unable to
    process a new character at the current rate.  Valid range is from 0 to
    9999 msec.


    GMT offset    [5]   (Eastern Standard Time)

    The GMT offset is the number of hours your time zone varies from
    Greenwich Mean Time.  This value is used when determining the correct
    file date and time from systems using properly implemented YModem and
    ZModem protocols.  In many Zmodem & YModem implementations this field
    is completely ignored, and will not affect the date and time stamp of
    your files.  Some TurboTerm installations may require that files be
    updated on a periodic basis from various locations around the world.
    When both the remote and local system recognize a GMT offset value,
    and your system is configured to allow only Newer files under ZModem,
    TurboTerm will only process updates to files that are truly newer than
    those currently on your system.


    ZModem options

    Chuck Forsberg, the designer of the Zmodem protocol, should be
    recognized here for his superb protocol.  If you don't use Zmodem
    regularly, then read on and find out why you should!  Zmodem is a
    streaming protocol that has an average CPS rate 30 to 70 percent
    faster than all other protocols internal to TurboTerm, with the
    possible exception of Ymodem G.  Zmodem provides crash recovery
    ability, allowing you to resume an interrupted file transfer.  ZModem
    allows either software or hardware flow control for controlling the
    flow of data, and has its own special file management options that
    allow you to fully customize the way you receive and send files while
    connected to remote systems.  Zmodem has one of the best error
    detection/correction schemes around, and provides the means to

 09-01-91                                17



 TurboTerm 2.0                      TTSetup                         Protocols

    automatically download files without user prompting.  Zmodem has the
    ability to transfer files in batch mode, facilitating multiple file
    transfers within a single protocol invocation.

    The following options control the way the Zmodem implementation
    operates.


    Crash recovery    [Yes]

    Zmodem crash recovery is perhaps the best reason to use Zmodem
    whenever possible.  This is an extremely handy feature when you are on
    an unreliable connection.  Imagine you are downloading a 400K file,
    and have completed 300K so far, when suddenly your modem hangs up the
    phone line.  With any other protocol, you would have to restart the
    transfer over from the beginning.  With Zmodem, you can restart from
    where you left off!  All you have to do is call the host system back,
    and restart the transfer.  Seriously consider NOT disabling this
    option.


    Auto downloading     [Yes]

    Another handy Zmodem feature is its automatic initiation of a Zmodem
    file transfer.  When you have this feature enabled and start a Zmodem
    download from the host system, you will not have to do anything else.
    Zmodem will automatically start up and perform the transfer.  The
    file(s) will be placed in your default download directory.


    Skip if no file    [No]

    This option allows you to configure Zmodem to allow file updates.
    If your system does not currently have the file that you are
    attempting to download, that file will be skipped and NOT downloaded.
    Be careful when turning this option on.  You may begin to think that
    Zmodem isn't working correctly if you enable this feature and try to
    download files that don't already exist on your system.


    Override sender    [Yes]

    Zmodem has the ability to let the host system determine where to place
    the file on your system, and whether or not to overwrite existing
    files.  (These options are called file management options)  Obviously,
    under normal circumstances you would not want GEnie or a BBS to decide
    where on your hard drive to place the file, so you should always
    override the senders file management options.


    Management options     [Newer/Longer]

    Zmodem has a variety of file management options that will allow you to
    customize how and when files get written to your hard drive during a
    download, and to request certain file management options from the host
    system when you are uploading.



                                         18                          09-01-91



 TurboTerm 2.0                      TTSetup                         Protocols

        Newer/Longer

        Instructs Zmodem to allow only new files, or files that are newer
        or longer than the file currently on your system.

        Append

        Instructs Zmodem to allow only files that are new, and to append
        to files that already exist.  This is not to be confused with
        crash recovery.

        Always

        Instructs Zmodem to always accept the file regardless of the file
        size or date, and overwrite any file of the same name currently in
        the specified download path.

        Newer

        Instructs Zmodem to accept only files that are new or newer than
        files of the same name currently on your system.

        Different

        Instructs Zmodem to accept only new files, or files by the same
        name that exist on your system with different file sizes or dates.

        Protect

        Instructs Zmodem to only accept files that are new.

    The default option [Newer/Longer] should be sufficient for most Zmodem
    transfers.  The other options would be used in a very specific job,
    and should only be set if you are familiar with the consequences of
    each option.



    Kermit Options

    The TurboTerm Kermit implementation is the only internal binary file
    transfer protocol that is capable of transmitting over a line with
    line settings other than N81.  Kermit will work on N81 or E71
    connections.  This is not to say that if you are logged onto GEnie at
    E71, that you must use Kermit (highly difficult since GEnie does not
    support Kermit), but it does mean that TurboTerm will not
    automatically switch to N81 when performing Kermit file transfers.

    Under most circumstances, you should never have to adjust the Kermit
    options.  Under some specialized circumstances, you may have to adjust
    these options to allow transfers to occur properly between the wide
    range of Kermit implementations.







 09-01-91                                19



 TurboTerm 2.0                      TTSetup                         Protocols

    Maximum packet length    [80]

    The maximum packet length is the number of characters per data
    subpacket transferred during a Kermit transfer.  The allowable range
    is from 0 to 91.


    Pad count    [000]

    The pad count is the number of pad characters to send between each
    Kermit datapacket.  The only time you might need padding is when the
    remote system requires a delay between sending you a packet and being
    able to accept a packet itself.  TurboTerm will automatically adjust
    this value to the pad count requested by the remote, so adjusting this
    value should only be necessary with Kermit implementations that do not
    realize that they require padding.


    Pad Character    [0]

    The pad character is the character that TurboTerm will use to pad each
    successive Kermit datapacket.  This value is ASCII value of the pad
    character. Range: 0 through 255.


    Terminator character    [13]

    The terminator character is the last character following the check
    character in a Kermit datapacket.  The terminator character is used by
    systems that require an end of line character before they can start
    processing input.  This value is the ASCII value for the terminator
    character.  Range 0 through 255.


    High bit prefix     [089]

    The high bit prefix is the character prefix that Kermit will use when
    transforming high bit characters (when using 7 data bits) into
    characters without the high bit set.  Normally you will not need to
    adjust this prefix.  This value is the ASCII value for the high bit
    prefix.  Range 0 through 255.


    Control prefix     [35]

    The control prefix is the character prefix that Kermit will use when
    transforming control characters into printable ASCII characters.
    Normally this value does not need to be changed.  This value is the
    ASCII value for the control prefix.  Range 0 through 255.










                                         20                          09-01-91



 TurboTerm 2.0                      TTSetup                         Protocols

    Maximum timeout    [5]

    The maximum timeout value is the amount of time in seconds that Kermit
    will wait for a new packet or the next byte of data.  If this time
    period elapses without a response, then TurboTerm will assume that an
    error has occurred, and will re-send its last packet.  Range 0-99
    seconds.


    Error check     [1 byte checksum]

    The error check type is the type of data integrity checking used
    by default during a Kermit transfer.  1 Byte checksum is supported by
    all Kermit implementations.  2 byte checksum is a slightly more
    reliable error checking type, and 3 byte CRC is the most reliable form
    of Kermit error checking available, but is not supported in all Kermit
    implementations.


    Restore Kermit defaults

    This option should be used to return the Kermit options to the
    installed TurboTerm defaults.



    User protocol options

    In the unlikely event that you find a protocol driver superior to
    those provided internally in TurboTerm, or if you wish to try out that
    new ABCmodem protocol, TurboTerm provides a convenient way for you to
    do so.  TurboTerm will allow you to define up to three separate
    protocols, each with their own distinct upload and download
    parameters.  User protocols are handled similar to the method employed
    for user shells, with two minor differences.  Since most external
    protocols require different command line switches for uploading and
    downloading, TurboTerm provides a place where both sets of parameters
    may be specified.  This is different than the user shells where only
    one set of parameters may be specified.  The other minor difference is
    that TurboTerm will not prompt you to 'Press any key to return to
    TurboTerm' when shelling to an external protocol.  We assume that
    after completing any binary file transfer you will want to return
    immediately to the comfort and familiarity of TurboTerm.

    Lets say you wish to use DSZ (Chuck Forsberg's Zmodem driver) for all
    of your Zmodem file transfers, and you want DSZ to show up as a valid
    protocol in your download and upload pick lists inside TurboTerm.  The
    following discussion will assume that you are currently running on
    COM2 at 2400 baud.  If your setup is different than this, you will
    need to change some or all of the parameters listed below.









 09-01-91                                21



 TurboTerm 2.0                      TTSetup                         Protocols

      - Select 'User protocol 1'

          Type in the full path and filename of DSZ.

          Example: C:\UTILS\DSZ.COM

      - Select user protocol 1 upload parameters.

          Type in your upload parameters.

          Example: port 2 -r sz

            In this case you would not want to specify your filenames here
            inside TTSetup.  Just prior to shelling to this protocol
            driver, TurboTerm will prompt you for any further parameters,
            and it is at this point that you will type in the filename(s).

      - Select user protocol 1 download parameters.

        Type in your download parameters.

          Example: 1 2400 rz

            Since DSZ's Zmodem automatically gets the filename from the
            sending system, no file name should be specified on this
            command line, either.  Again, TurboTerm will prompt you for
            any additional parameters just prior to executing this shell.

      - Select protocol name

        Type in DSZ, or whatever best describes the protocol you are
        installing.  You are limited to 10 characters for the name.

      - That's it.  You have successfully installed DSZ as an external
        protocol.

     Some common mistakes:

          - You didn't properly type in the filename and path of the DSZ
            program.

          - You don't have a copy of DSZ on your system.

          - Your upload/download parameters are incorrect for your system
            setup.

          - You have insufficient free memory to run the external
            protocol. (see the section on memory management below)











                                         22                          09-01-91



 TurboTerm 2.0                      TTSetup                           Options


    This menu selection will allow you to customize the various operating
    parameters of TurboTerm to best suit your individual taste, and
    conform to your system's requirements.


    Connect Sounds    [Yes]

    This toggles whether you will be alerted upon connecting to a system
    listed in your dialing directory.


    Warning sounds    [Yes]

    This controls whether you are audibly warned when attempting an
    operation that cannot currently be performed in TurboTerm.  TurboTerm
    uses this check to determine if any sounds will be generated on any of
    these attempts.  Some sample circumstances where TurboTerm would
    produce this sound are listed below:

           - You attempt to scroll past the beginning or end of the
             scrollback buffer.

           - You attempt to recall a command in the chat recall buffer
             beyond the recall buffer limit.

           - You attempt to change to ANSI emulation <Alt-Y> when in split
             screen (buffered) mode.

           - You attempt to use the dialing directory <Alt-D> when you
             have TurboTerm's null modem feature active.

           - You attempt to search scrollback <Alt-F> when scrollback is
             not currently being displayed on screen.

           - You attempt to change your chat mode options <Alt-G> when
             chat mode is not active.

           - You attempt to edit a chat buffer command <Alt-V> when not in
             chat mode.



    Auto log usage    [No]

    Turning this option on will force all connections to remote systems
    to be logged to the default usage log.  When this option is off, no
    usage logs will be created, except for those that are specifically
    designated in the dialing directory entries.  For a detailed
    description of TurboTerm's usage logs, refer to Appendix B.









 09-01-91                                23



 TurboTerm 2.0                      TTSetup                           Options

    Verbose usage    [Yes]

    When this option is on, all usage files will be written in the verbose
    format.  Refer to the descriptions in Appendix B for verbose and brief
    usage logs.


    Scroll size    [9]

    This option controls the number of lines in scrollback that will be
    displayed on the screen when entering scrollback.  This number does
    NOT affect the size of the scrollback window when ANSI emulation is
    turned on.  In ANSI emulation, the scrollback window is always full
    screen, since the ANSI specification requires (at least) a 24 line
    terminal window.  When inside TurboTerm this number can be adjusted
    using the <Ctrl-PgUp> and <Ctrl-PgDn> keys.  The new value set while
    inside TurboTerm is only in effect for the current TurboTerm session,
    and is reset to the configuration value during all subsequent
    sessions.


    Dialer timeout    [30]

    This is the number of seconds TurboTerm will wait for a connection or
    error response during a dialing attempt, before initiating a redial.


    Recycle delay    [5]

    This is the number of seconds TurboTerm will wait between dial
    attempts.


    Emulation     [TTY]

    The emulation is the way TurboTerm will interpret incoming characters
    and place them on the screen.  TurboTerm has four built-in terminal
    emulations: TTY, ANSI, DEBUG_ASCII, and DEBUG_HEX.  Only TTY or ANSI
    may be selected as the default terminal emulation.  The two debug
    emulations are used for trying to determine the exact character
    sequence that a remote system is sending, and can be useful when
    attempting to debug a particular script or program.


        TTY:

        TTY terminal emulation emulates the old-style teletypewriters, and
        offers no special color options.  It is a character-only based
        terminal emulation.  TTY emulation is sometimes referred to as a
        dumb terminal since it does no interpretation of the incoming
        characters, and does not allow cursor positioning or color
        changes.

        ANSI:

        The ANSI (American National Standards Institute) driver in
        TurboTerm is a subset of the full ANSI terminal standard, and
        conforms to the IBM ANSI.SYS driver specification.  The ANSI

                                         24                          09-01-91



 TurboTerm 2.0                      TTSetup                           Options

        specification requires that the terminal screen be 24 rows by 80
        columns.  ANSI emulation interprets incoming characters and
        processes any escape sequences to determine cursor positioning
        and color attributes.  You will commonly find ANSI emulation in
        use on private BBS systems around the country.  GEnie and
        Compuserve make very little use of the ANSI specification.  Unless
        you have a specific need for ANSI when on these systems, it is
        recommended to use TTY terminal emulation.

        DEBUG_ASCII:

        The DEBUG_ASCII emulation is used when trying to determine the
        exact sequence or character string that a remote system is
        sending.  Debug_Ascii will display all printable characters (ASCII
        32 through 255) normally and place all control or non-printable
        characters in brackets ([]) to help you determine the actual
        string being sent by the remote system.

        DEBUG_HEX:

        The DEBUG_HEX emulation is similar to the DEBUG_ASCII emulation
        except that ALL received characters are displayed with their
        corresponding hexadecimal values in brackets ([]).


    Macros

    A macro is a pre-defined string.  Under many circumstances, you will
    find it useful to have certain strings saved so that you can quickly
    recall them without having to manually retype the line.  TurboTerm
    allows up to ten macros to be active at any given time, but you can
    have as many macro files (each with 10 pre-defined strings) as disk
    space allows on your system.  Each of the macros in TurboTerm is
    played back by pressing the corresponding function key (F1 - F10) on
    your keyboard.  Each macro may contain up to 255 characters, including
    any imbedded control characters.  Multiple line macros can be formed
    by imbedding carriage returns inside a given macro.  TurboTerm's macro
    editor has many special commands to allow quick and efficient editing.
    Refer to the <Alt-V> section in this manual for further instructions
    on editing.  Two other specialized macros can also be defined.  These
    macros are GEnie specific and only work in GEnie Chat Lines & GEnie
    RTC split-screen (buffered) modes.  The AFK and Auto-Greet macros
    follow the same limits as the F1-F10 macros on length and imbedded
    control characters.  Each macro file must reside in your TurboTerm
    directory, and must have a file extension of .KEY.



    Macro File    [TT.KEY]

    The macro filename you specify here is the default macro file you
    wish be active upon program initialization.  As an added convenience,
    macro files may be edited inside TTSetup or from within TurboTerm.  To
    change the default macro file, select File and type in the filename of
    the macro file you wish to load by default.




 09-01-91                                25



 TurboTerm 2.0                      TTSetup                           Options

    F1-F10 Macros    [Empty]

    The F1-F10 macros are configured by selecting the macro you wish to
    edit, then using the editor commands to fill in the appropriate text.


    AFK Macro    [I'm sorry, I am currently AFK, please try again later]

    The AFK macro is used in GEnie Chat Lines or GEnie RTC's to alert
    people that send you private messages that you are away from your
    keyboard.  When TurboTerm senses that you have received an incoming
    private message, it will automatically send this string in response to
    the sender in a private message while the AFK feature is active.  The
    AFK message may contain any phrase, and we encourage you to customize
    yours to fit your personality.  One of the more humorous AFK macros
    spotted during the beta cycle was:  "Holy cow!!!!  Just as your /SEN
    arrived my monitor burst into flames!  I'll be right back...".  We do
    not recommend, of course, continuing a telecommunications session if
    your equipment is malfunctioning in this manner.


    Auto-Greet Macro    [Hi {Handle}!]

    The auto greet macro is used when you wish to seem cordial or friendly
    to anyone who happens to drop by your current channel or conference
    room.  Again, this is a specialized macro that only works in GEnie
    Chat Lines and GEnie RTC's.  Since it seems more cordial to greet a
    person by his/her handle, the Auto-Greet may contain a special
    indicator, showing where TurboTerm should insert the handle.  You can
    specify where in the Auto-Greet string you wish to place the handle of
    the person that just entered the channel by placing the special
    keyword {Handle} somewhere in the Auto-Greet string.  If {Handle} is
    not specified then the Auto-Greeter will simply display the message
    without a handle.  The Auto-Greeter can be very useful when you are
    hosting a discussion, or chairing a conference.

      Example:

        "{Handle}, welcome to the support conference.  If you have any
        questions, feel free to ask."


    File Names

    Almost all file names that TurboTerm uses can be configured to suit
    your needs.  The only exceptions to this rule are:

         -  All phone files must have a .FON extension.

         -  All macro files must have a .KEY extension.

         -  The TurboTerm configuration file must be called TT.CFG

    The names that you specify in TTSetup will be the default filenames
    for your capture logs, phone file, scrollback save files, and usage
    logs.



                                         26                          09-01-91



 TurboTerm 2.0                      TTSetup                           Options

    Log File    [TT.LOG]

    This is the default name to use for all capture logs.  Capture logs
    are not to be confused with usage logs.  Capture logs are a capture of
    the telecommunications session.  When a log file is turned on, all
    information received through the port will be written to the
    specified file.  This is especially useful if you are browsing through
    some material and wish to save it for later viewing.  When in
    TurboTerm, logging to disk is activated by typing <Alt-L>.  If the
    file that you specify here already exists, you will be prompted to
    Append, Overwrite, or start a New log file.  All LOG files will be
    written to your LOG directory.


    Phone file    [TT.FON]

    This is the file that contains phone numbers and other information for
    all your frequently called numbers.  The phone file contains various
    information that will allow you to customize each session without
    changing your defaults inside TTSetup.  The extension of all phone
    files must be .FON.  All phone files will be written to your TurboTerm
    directory.


    Scroll back    [TT.SBK]

    This is the default file name that TurboTerm will use when you choose
    to save the contents of your scrollback buffer to disk.  If the file
    already exists, TurboTerm will prompt you to Append, Overwrite, or
    start a New scroll back file.  All scroll back files will be written
    to your TurboTerm directory.


    Usage file    [TT.USE]

    This is the default name for TurboTerm to use when a request for a
    usage log is made via the dialing directory or when the Auto-Log
    parameter is active.  This filename has no effect on usage log names
    that are specified in the dialing directory.  All usage logs are
    written to your LOG directory.



    Chat options

    This option will allow you to change the behavior of split screen
    operations inside TurboTerm.  TurboTerm's split screen mode has three
    possible configurations:  GEnie Chat, GEnie RTC, and Normal.  With
    this option you can customize your split screen operations to suit
    your personal taste.  Each mode has a specific way of handling/parsing
    incoming text, and you must select the correct mode based on your
    current situation.  All of these options can also be set inside
    TurboTerm.






 09-01-91                                27



 TurboTerm 2.0                      TTSetup                           Options

    Chat mode    [GEnie Chat]

       Normal:

          This mode of split screen operation does no parsing of the
          incoming text, and disables the specialized GEnie functions
          like Auto-Show, Auto-Greet, Alert, Die Roller, and AFK Mode.


       GEnie Chat:

          This mode of split screen operation parses incoming text and
          waits for private sends, new logons or monitorings, and die roll
          requests.  The state of the toggles explained below determine
          which options will be active by default, when in GEnie Chat
          mode.


       GEnie RTC:

          This mode of split screen operation parses incoming text and
          waits for private sends, new logons or monitorings, and die roll
          requests.  The state of the toggles explained below determine
          which options will be active by default, when in GEnie RTC
          mode.


    Auto-Show    [No]

    Auto show is a GEnie-specific function, that will automatically
    perform a /SHO command whenever someone enters or monitors your
    channel.  The return information from GEnie will be highlighted in
    your terminal highlight color.  Toggling this option enables/disables
    the default setting of the Auto-Show feature.


    Auto-Greet    [No]

    Auto-Greet is a GEnie-specific function that automatically greets
    visitors to your channel or conference room, and waves at those that
    monitor your channel.  The Auto-Greet feature can be further
    configured by altering your Auto-Greet macro, discussed in the macro
    section of this manual.  Toggling this option enables/disables the
    default setting of the Auto-Greet feature.


    Alert    [Yes]

    The alert feature is a GEnie-specific function that controls whether
    TurboTerm will sound a tone every time a private message is sent to
    you.  This is quite useful on busy channels, where you might miss the
    private message.  The tone will alert you that a private message was
    sent to you, so that you may respond accordingly.  While all other
    GEnie-specific options work only in split screen mode, this option
    also controls one other feature of TurboTerm.  With this toggle set to
    Yes, you will also be alerted of any  notifies that you receive while
    on GEnie.


                                         28                          09-01-91



 TurboTerm 2.0                      TTSetup                           Options

    Die roller    [No]

    The die roller is a GEnie-specific function that allows anyone
    currently on your channel to roll a specific number of dice by simply
    typing an appropriate command. (.r##d###[+/-##])  This will instruct
    TurboTerm to respond with a random die roll meeting the request.  The
    modifier is the only optional parameter.

        Example:

        Suppose your handle was <Dungeon Master> and <CrystalStar> wanted to
        roll five ten-sided dice.

        <CrystalStar> .r5d10+5
        <Dungeon Master> CrystalStar: 5 + 3 + 6 + 7 + 2 = 23 Modified: 28

        This example shows the requestor's name, followed by the die roll
        results.  The modifier, if present, is added to (or subtracted
        from) the combined total of the rolled dice and reported as well.

    Any roll that does not meet the limits of TurboTerm's die roller will
    display an invalid roll message and an example of the correct syntax.


    AFK Mode    [NO]

    The AFK mode is a GEnie-specific function that determines whether the
    AFK macro will automatically be sent in reply to all private /SEN's.
    It is not recommended that this mode be active by default, but the
    ability exists for specific implementations.


    Window Options

    This allows you to customize the look and feel of the pop-up windows
    inside TurboTerm.  TurboTerm windows are capable of shadowing effect,
    exploding window effects, and sound effects.  These options may be
    configured to suit your tastes.


    Exploding windows    [Yes]

    Having this option on will cause all new pop-up windows in TurboTerm
    to appear to "grow" from the center of the screen, and to shrink in
    an opposite manner when the window is removed.  In many of today's
    applications, exploding windows are commonplace.  If you wish to
    disable exploding windows, then set this option to NO.


    Sound Effects    [No]

    Sound effects are the accompanying sounds to the exploding windows.
    If exploding windows are turned on, then enabling sound effects will
    cause a tone to accompany all exploding windows.  The longer the
    window takes to explode, the longer the sound/tone will be.




 09-01-91                                29



 TurboTerm 2.0                      TTSetup                           Options

    Window Shadows    [Yes]

    All of TurboTerm's windows are capable of having a shadow.  This
    shadow makes that window appear to be raised from the surface of the
    screen behind it.  The shadow itself will not obscure any of the text
    below it.


    Window Delay    [2]

    On slower machines, the exploding windows can be agonizingly slow.
    The window delay is a user-defined factor which controls the length of
    the window delay.  The lower the number, the faster the window will
    explode onto the screen.  Range: 0 - 20.



    Memory Usage

    The memory usage option allows you to configure the way that
    TurboTerm will execute other programs.  TurboTerm has the ability to
    perform two styles of program execution; shelling and swapping.
    Shelling is a method in which TurboTerm will free up as much memory as
    possible, and execute a secondary program.  While this method is the
    fastest way to execute other programs from inside TurboTerm, the
    available memory for the child program could be as low as 100k.  If
    you plan on running only very small programs from inside TurboTerm
    (such as LIST.COM) then shelling may be right for you.  On the other
    hand, when you have programs that require large amounts of memory to
    run, and you would still like to be able to have access to them from
    inside TurboTerm, then you should enable swapping.  TurboTerm has the
    ability to write an image of itself to EMS 4.0 or to disk.  This frees
    up all but approximately 55K of your regular memory for other programs
    to run.  Swapping to a floppy disk is not allowed, as the speed of
    floppy drives is not sufficiently fast enough to make swapping a
    viable choice.  If you have a hard drive, a ram drive, or EMS 4.0
    compliant memory with approximately 400k available, then swapping is
    the preferred solution.  Swapping takes slightly longer than shelling
    (especially on a slow hard drive), but the advantage is that you
    shouldn't encounter insufficient memory messages when attempting to
    run any of your applications.  You should also note that TurboTerm
    MUST turn off the communications port prior to swapping to disk.  Upon
    returning from a swap, TurboTerm will re-initialize your communication
    port to the settings that were in effect prior to initiating the swap.


    Allow Swapping    [No]

    When this option is enabled TurboTerm will write an image of itself
    to EMS 4.0 or disk, based on the next two options.  This image file
    can be as large as 400K, so you must have at least that much free disk
    space or EMS, to successfully swap.  When swapping is turned off, a
    normal shell is performed, which will significantly reduce the amount
    of available memory available to your application.  If, for any
    reason, TurboTerm is unable to shell or swap, a message explaining the
    reason will be displayed.



                                         30                          09-01-91



 TurboTerm 2.0                      TTSetup                           Options

    Use EMS for swap    [No]

    If your system has at least 400K of EMS 4.0 memory, then you should
    use this option to optimize swapping.  Your EMS driver must be EMS 4.0
    compliant.  Known EMS drivers that work with TurboTerm are 386Max,
    QEMM386, and EMM386.  All of these drivers have been successfully
    tested with TurboTerm.  Some EMS cards for XT & AT class machines will
    work as well.  We recommend that you first try using EMS for swapping,
    but if TurboTerm does not successfully swap to your EMS memory, this
    option should be disabled.  Enabling this option when you do not have
    any EMS memory should not cause a problem with TurboTerm, since it
    checks for sufficient EMS memory prior to swapping.


    Swap path    [TurboTerm directory]

    As mentioned before TurboTerm has the ability to swap to disk.  If you
    are running TurboTerm from a slow hard drive or floppy system, and you
    wish to have TurboTerm write its image file out to a faster hard drive
    or to a ram drive (recommended), then set this option to the desired
    destination.  TurboTerm has been successfully tested with DOS 3.3's
    VDisk and DOS 4.x/DOS 5.0's Ramdrive.  Both of these programs allow
    you to create a ramdrive from either Extended or Expanded memory.  If
    your system is equipped with extended memory, a ram drive is
    recommended.  For those that have EMS memory that TurboTerm cannot
    access, this is option suggests another solution.  Set up a ram drive
    in your EMS memory, and point your swap path to that ram drive.  For
    information on setting up a ram disk, refer to Appendix A.



    Clipboard options

    The TurboTerm Clipboard is one of the more powerful features of
    TurboTerm.  It allows you to edit standard text files, as well as cut
    and paste from your current telecommunications session.  To allow you
    to utilize the clipboard to meet your specific needs, TTSetup provides
    the means to configure many of the clipboard's functions.


    Insert mode    [Yes]

    This option determines whether the clipboard will be in insert or
    overwrite mode when you first enter the clipboard.


    Word wrap mode    [Yes]

    This option determines whether text that you type in the clipboard
    will automatically wrap to the next line when you reach the right
    margin.








 09-01-91                                31



 TurboTerm 2.0                      TTSetup                           Options

    Indent mode     [No]

    This option determines whether the clipboard will automatically follow
    the previous line's indent.


    Warning Time    [2]

    This option specifies the amount of time (in minutes) that will pass
    while you are in the Clipboard, before TurboTerm issues a warning
    tone.  This option is useful when you find yourself in TurboTerm's
    clipboard longer than the timeout value on the remote system.  This
    warning tone will alert you that it is time to exit the clipboard and
    resume your remote session.  Setting this value to 0 will disable the
    warning tone.












































                                         32                          09-01-91



 TurboTerm 2.0                      TTSetup                              Exit


    Once you have made the necessary changes to your TurboTerm
    configuration file, you should exit and save your changes.  If you
    wish to abandon any changes that you made while in the program, select
    Abandon on the exit menu.  If you select Abandon, none of the changes
    will be saved, and your old setup will remain in effect.





















































 09-01-91                                33



 TurboTerm 2.0                 Program Reference


    TurboTerm has many advanced features available from within the
    terminal itself.  Each of these features is described in the
    paragraphs that follow.


    Prefix      <Alt-A>

    TurboTerm's built-in prefix function has a dual purpose in TurboTerm.
    Each line transmitted from the TurboTerm Clipboard via <Alt-F6>
    (transmit) or <Alt-F7> (*UPLOAD) will first be appended to the defined
    prefix (when active), then sent to the remote system.  This allows
    TurboTerm users a handy "quote feature", if one is not implemented on
    the remote system.  In a similar fashion, each line typed in buffered
    mode (Alt-B) will be appended to the defined prefix string (when
    active), prior to being sent to the remote system.  This gives
    TurboTerm users the ability to easily carry on a private conversation
    in GEnie's RTC or Chat Lines, and can also make game playing in those
    environments quite a bit easier.

    To edit your current prefix, type <Alt-A>.  A small menu will appear
    showing your current prefix and three choices:

          <A>ctivate,  <D>eactivate, and <E>dit.

    From this menu, you can toggle the state of your prefix, or edit the
    prefix string.  Editing the prefix will automatically activate it, so
    there is no need to call up this menu again to activate a prefix
    string you just finished defining.  To deactivate the prefix string
    without redefining or erasing it, simply use the deactivate option on
    this menu.  The prefix string will remain intact, but inactive.  To
    activate the prefix again, use the activate option on this menu.

    If you do not wish to continuously deactivate and reactivate your
    prefix, you may override its operation on a line-by-line basis by
    beginning the line with a '/' character.  Since all commands in
    GEnie's RTC and Chat Lines software begin with this character, this
    allows you to access those commands without the need of first
    deactivating the prefix.  Beginning the line with a '/' followed by a
    space will allow you to send a normal line without the prefix.  Since
    GEnie interprets any line beginning with a '/' as a command, both the
    '/' and the space are trimmed from the beginning of the line, and the
    line is then sent (without the prefix).  Typing the line this way will
    allow messages to be sent "on open" in the GEnie Chat Lines and
    RTC's, without the need of first deactivating your defined prefix.


    Buffered Mode    <Alt-B>

    TurboTerm's buffered mode (also called chat mode, or split-screen
    mode) is most often used while 'chatting' with other people on GEnie
    Chat Lines or in a Real Time Conference (RTC).  Buffered mode prevents
    your typed text from being overwritten by another person's text while
    you are still typing.  This is accomplished by displaying incoming
    text in the upper (terminal) window, while the text you're typing is
    displayed in the lower (buffer) window.  While it is not necessary to
    use buffered mode in these situations, it does make the session easier
    to read.

                                         34                          09-01-91



 TurboTerm 2.0                 Program Reference


    TurboTerm's buffered mode also allows you to edit your text prior to
    sending it, using the <Alt-V> buffer editor.  Any of the preceding 25
    lines sent can also be "recalled" and re-sent, if desired, using the
    Command Recall function.  While in buffered mode, the left- and
    right-arrow keys can be used to "scroll" through the previous lines.
    While the line is displayed in the buffer, it can be re-transmitted by
    simply pressing the <Enter> key.  Each time a line is transmitted, it
    is added to the recall buffer.  You may also add lines to the recall
    buffer without transmitting them, by pressing <Ins> instead of
    <Enter>.

    Finally, TurboTerm's buffered mode has three interfaces available:
    Normal, GEnie Chat Lines, and GEnie RTC.  The <Alt-G> menu allows you
    to change the current interface, as well as toggling various buffered
    mode options.  The current state of these options, as well as the
    number of characters currently in the buffer, are displayed on the
    "chat bar" that separates the terminal and buffer windows.


    Clear screen    <Alt-C>

    To clear the terminal screen at any time, press <Alt-C>.  The screen
    will be cleared to the color in the terminal window.


    Dialing directory   <Alt-D>

    The TurboTerm dialing directory is used to establish a connection to
    one of sixty directory entries, or to a manually entered number. A
    number of entries may be "tagged" and dialed, in which case TurboTerm
    will dial each tagged entry in a round-robin fashion until a
    connection is made.  Each entry in the dialing directory has an
    associated group of terminal settings, as discussed in the chart
    below:

        Field        Description
        -----        -----------

        Name:        The name associated with this entry.

        Number:      The number of the remote system.  This field would
                     also include any digits required to access an outside
                     line, disable call-waiting, etc.

        Baud:        The baud rate of the system associated with this
                     entry.  This should reflect the maximum baud rate at
                     which you expect to connect to the remote system. The
                     only exception to this would be for those using error
                     correcting modems, where the baud rate is "locked" at
                     a rate higher than the actual connect rate.

        Parity:      This field should reflect the parity setting needed
                     to connect to the remote system associated with this
                     entry.




 09-01-91                                35



 TurboTerm 2.0                 Program Reference

        Data Bits:   This field should reflect the number of data bits
                     expected by the remote system associated with this
                     entry.

        Stop bits:   This field should reflect the number of stop bits
                     expected by the remote system associated with this
                     entry.

        Local echo:  Also called duplex setting.  Local echo on is
                     equivalent to half duplex.  In most cases, this
                     should be set to 'Yes' for 7 bit connections, and
                     'No' for 8 bit connections.

        Chat mode:   This field is a toggle that determines whether
                     TurboTerm will automatically switch into buffered
                     mode upon connecting to the remote system associated
                     with this entry.

        Emulation:   This field should reflect the terminal emulation
                     expected to be in use by the remote system associated
                     with this entry.

        Script:      This field contains the name of the linked script
                     that TurboTerm should execute upon successfully
                     connecting to the remote system associated with this
                     entry.  The script itself should reside in the
                     defined TurboTerm script directory.  The most common
                     usage for this function is to automatically perform
                     the actions necessary to log on to the remote system.

        Password:    This field contains the password or logon sequence
                     needed for the remote system associated with this
                     entry.  The string defined here can be transmitted to
                     the remote system via the {Password} script variable
                     in the attached script file, or by typing <Alt-F1>
                     within the first two minutes of connection.

        Usage log    If a usage log for this entry is desired, select
                     'Yes'.  Selecting 'No' at this prompt will skip the
                     next field.  Note that if usage logs are turned on
                     globally in the configuration file, selecting 'Yes'
                     here will allow you to specify a log file different
                     from the default.  Selecting 'No' while the global
                     usage log is active will cause usage statistics to be
                     written to the default usage log file.

        Usage name:  If 'Yes' was chosen above, a usage log name may be
                     specified at this prompt.

        Protocol:    This field should reflect the desired default binary
                     transfer protocol for the remote system associated
                     with this entry.







                                         36                          09-01-91



 TurboTerm 2.0                 Program Reference

        Clear usage
        stats:       This prompt allows you to clear out all statistics
                     associated with this entry.  Selecting 'No' will
                     cause the previously accumulated statistics to remain
                     in place.

    While inside the dialing directory, the available commands are listed
    at the bottom of the directory screen.  Aside from actually dialing
    the entries listed, functions are available here to tag, untag, edit
    and delete entries, save the current directory to disk, load an
    alternate phone directory, and view extended information for each
    entry.  These functions, as well as sorting, global changing, and
    importing other directory formats are available in the TTFON
    stand-alone utility.


    Toggle duplex (Local Echo)   <Alt-E>

    To toggle between full and half duplex while inside the terminal, use
    the <Alt-E> command.


    Find Text    <Alt-F>

    When scrollback is active the <Alt-F> key will allow you to perform a
    case insensitive text search from the current position to the end of
    the scrollback buffer.  If the text is found, the line containing the
    search string will be located at the bottom of the scrollback window.
    The search string is not reset after each successful search, so that
    multiple searches may be performed using successive <Alt-F> searches.


    Chat options    <Alt-G>


        Normal Chat:  Normal chat disables all the GEnie specific
                      functions, and makes buffered mode function as it
                      would in most other terminal programs.

        GEnie Chat:   GEnie Chat enables the special features associated
                      with TurboTerm's Chat Lines interface.  These
                      features include: Auto-Show, Auto-Greet, Alert, Die
                      roller, And AFK modes.  Use this chat mode if you
                      are GEnie's Chat Lines.

        GEnie RTC:    GEnie RTC enables all of the special features as the
                      GEnie Chat interface, but is structured to work
                      within GEnie's Real Time Conferences.  Since
                      the RTC software on GEnie has a slightly different
                      set of commands, a separate interface is required to
                      activate these features there.








 09-01-91                                37



 TurboTerm 2.0                 Program Reference

        The <Alt-G> menu lists the GEnie specific functions as well.
        These are Auto-Show, Auto-Greet, Alert, Die roller, and AFK modes.
        To toggle any of these options ON or OFF type <Alt-G> and cursor
        down to the option to toggle, and press <Enter> or use the
        highlighted hot-key.  When all preferences are set as desired
        press <Esc> to exit.  These defaults will remain in effect for the
        remainder of your TurboTerm session.  To make your preferences
        permanent, use TTSetup.  Below is a brief description, outlining
        what each of each of these functions does.

        Auto-Show     With this option active, TurboTerm automatically
                      requests extended information on people that enter
                      or monitor your channel.  This is analogous to
                      typing "/SHO <handle>" whenever anyone enters or
                      monitors your channel -- except you don't have to
                      type it.

        Auto-Greet    With this option active, TurboTerm automatically
                      "greets" people that enter the channel you are on,
                      using the currently defined greet string.

        Alert         With this option active, all private messages
                      received by TurboTerm will be highlighted and
                      accompanied by an alert tone.

        Die roller    With this option active, TurboTerm will parse each
                      incoming line for valid die roll sequences.  A valid
                      sequence matches the pattern ".r##d###[+/-##]".  An
                      example would be ".r5d12" or ".r10d20+15"

        AFK           With this option active, TurboTerm automatically
                      sends the defined AFK string in response to all
                      incoming private messages.


    Hanging up    <Alt-H>

    To terminate your current session without exiting TurboTerm, use the
    <Alt-H> hang-up command.


    Information    <Alt-I>

    This keystroke invokes an information screen outlining the current
    state of various TurboTerm parameters.  Pressing <Esc> will exit this
    screen and return you to your terminal session.  Any other keystroke
    will exit the screen, with the keystroke passed to the current
    session.


    Keyboard macros    <Alt-K>

    Macros in TurboTerm are predefined lines of text.  Each macro can
    be 255 characters in length, and you can have up to ten macros active
    at any one time.  The macro keys are F1 through F10.  Any number of
    macro sets can be loaded or saved from within the <Alt-K> definition
    screen.  Refer to the TTSetup section for information on how to define
    your default macro key file.

                                         38                          09-01-91



 TurboTerm 2.0                 Program Reference


        Editing macros:

        To edit a macro inside TurboTerm type: <Alt-K>  A popup window
        will show you the current macros that you have defined, and a list
        of available commands will be displayed at the bottom of the
        window. To select a given macro, either press the macro key (F1
        through F10) you wish to edit or the <G> and <A> keys for auto
        greet string, and AFK macros.

        Command   Function
        -------   ----------

         <L>       Load a new macro file.  The current macro filename will
                   be displayed in the window, and you can chose this file
                   by pressing <Enter>.  If you wish to load a new macro
                   file, erase the filename and type in the new name you
                   wish to load -- or press <Enter> at the empty prompt,
                   and a list of all macro files will be shown.

         <S>       Save the current macro definitions to disk.  The
                   current filename will be shown, and you can type
                   <Enter> to use this filename, or you may retype it to
                   save the file under a different name.

         <F1>-
         <F10>     You may edit any of these macro strings by typing the
                   associated function key for that macro.  To edit the
                   macro, use the line editor commands discussed
                   elsewhere in this documentation.

         <A>or<G>  Define your current AFK, and Auto-Greet macros.  Again,
                   use line editor commands discussed elsewhere in the
                   documentation.  The Auto-Greet string has the
                   additional feature of incorporating the "handle" of the
                   person that you are greeting by placing the {handle}
                   keyword at the appropriate spot in the macro string.

         <Esc>     Exits you from the macro editor.

         How macros work:

         When in normal terminal mode, your macro is automatically sent
         whenever that macro key is pressed.  When you are in buffered
         mode,  the macro string is appended to the current line in the
         chat buffer.  You must still press <Enter> to send your macro
         (and any other characters in the buffer).  Under certain
         circumstances, you may wish to have your F1 - F10 macros sent
         immediately, without necessarily exiting buffered mode.  If this
         is the case, then simply place a carriage return on the end of
         your macro with the macro editor.  To do this follow the macro
         line editor instructions found elsewhere in this manual.







 09-01-91                                39



 TurboTerm 2.0                 Program Reference

    Capture logs     <Alt-L>

    TurboTerm has the ability to log all communications port activity to
    disk.  This is sometimes called a capture log.  To start logging to
    disk, type <Alt-L>.  If the log file already exists, you will be
    prompted to overwrite, append or create a new log file.  If the
    default log file does not exist, TurboTerm will begin logging to that
    file immediately.  All log files are written to the defined TurboTerm
    log directory.  To stop the capture log, type <Alt-L> again.  While
    logging to disk, the word 'Log' will be shown on the status line.


    Marking text     <Alt-M>

    To mark text in scrollback, place the first line you wish to mark on
    the bottom of the scrollback window and press <Alt-M>.  To mark a
    series of lines, scroll through the scrollback text until the last
    line that you wish marked is shown on the bottom line of the
    scrollback window, and press <Alt-M>.  All lines between the first
    mark and the second mark will be highlighted.  Once a section of
    scrollback is marked, it can either be saved to disk or copied to the
    TurboTerm Clipboard.  Unmarking of scrollback will automatically be
    performed after copying the marked text to disk or to the clipboard.
    You can also manually unmark scrollback by typing <Alt-U>.


    Null modem      <Alt-N>

    Transferring files from one computer to another without a modem can be
    performed by connecting the two computers together using a null modem
    cable.  TurboTerm can perform binary file transfers using any of its
    built in protocols, at speeds up to 115200 Bps.  This is a handy
    feature for transferring files from your laptop to your desktop
    computer.  Enabling Null modem direct connects will disable all
    carrier checking, and display 'Direct' on the status line.


    Shelling to DOS    <Alt-O>

    To shell to DOS, type <Alt-O>.  The amount of memory available in DOS
    through this function is directly related to the disk-swapping
    parameter in the configuration file.  The possibility exists that you
    will be unable to shell to DOS under certain circumstances.  A
    temporary solution would be to delete the scrollback buffer (via
    <Alt-F4>) to free up more memory.  A more permanent solution would be
    to activate disk-swapping in TurboTerm's configuration file.  With
    disk-swapping active, all but approximately 55K of memory will be
    available through the <Alt-O> function.











                                         40                          09-01-91



 TurboTerm 2.0                 Program Reference

    Port configuration     <Alt-P>

    If you wish to alter the current communication parameters during a
    TurboTerm session, you may quickly do so by using the <Alt-P> option.
    The current line settings are displayed on the top line of the window.
    To change any of the current line settings, type the corresponding
    menu choice.  As you make changes, the top line will reflect your
    chosen settings.  Once all of the necessary changes have been made,
    press <Enter> to accept the settings.  Pressing <Esc> at any time
    while changing these parameters will abort the process and leave your
    communications settings unchanged.


    Running a script    <Alt-S>

    To run a script inside TurboTerm, type <Alt-S>.  At the prompt,
    type in the name of the script you wish to run.  Pressing <Enter> at
    the empty prompt will display a list of all scripts in your TurboTerm
    script directory.  After specifying a script at the prompt or
    selecting one from the list, TurboTerm will begin execution of the
    script.  A brief discussion of the TurboTerm script language
    commands can be found in Appendix C.


    Time and Date     <Alt-T>

    At any point, the current time and date can be displayed by pressing
    <Alt-T>.  TurboTerm will display the current date and time in the
    bottom left hand corner of the screen for approximately 10 to 15
    seconds.


    Unmarking     <Alt-U>

    You can manually unmark the scrollback buffer with the <Alt-U>
    command. All lines that are currently marked in scrollback will be
    unmarked.


    Buffer editor   <Alt-V>

    Editing a line in buffered mode is very much like editing in the
    various line prompts within TurboTerm.  Pressing <Alt-V> while in
    buffered mode will bring up the TurboTerm line editor, with the
    current line in the buffer automatically inserted.

    TurboTerm's line editor uses many of the WordStar commands you are
    probably already familiar with.  These commands will allow you insert,
    delete, and modify text quickly and painlessly.  The following list of
    commands will help you to familiarize yourself with the editing
    capabilities of the line editor.








 09-01-91                                41



 TurboTerm 2.0                 Program Reference

    Keystroke(s)     Function
    ------------     --------

    <Enter>          Accepts the current line, including any changes that
                     you have made to that line.

    <Esc>
    <Ctrl-Break>     Quit without making any changes to the line, and
                     return you to the terminal session.

    <Right Arrow>
    <Ctrl-S>         Moves the cursor right one space.

    <Left Arrow>
    <Crtl-I>         Moves the cursor left one space.

    <Ctrl-Left>
    <Ctrl-A>         Move the cursor left one word.

    <Ctrl-Right>
    <Ctrl-F>         Move the cursor right one word.

    <Home>
    <Ctrl-Q><S>      Move the cursor to the beginning of the line.

    <End>
    <Ctrl-Q><D>      Move the cursor to the end of the line.

    <Del>
    <Ctrl-G>         Delete the character at the current cursor position.

    <Backspace>
    <Ctrl-H>
    <Ctrl-Backspace> Delete character to left of the current cursor
                     position.

    <Ctrl-End>
    <Ctrl-Q><Y>      Delete from the current cursor position to the end of
                     the line.

    <Ctrl-Y>
    <Ctrl-X>         Unconditionally delete the entire line.

    <Ctrl-Home>      Delete from beginning of line to the current cursor
                     position.

    <Ctrl-T>         Delete the word to the right of the current cursor
                     position.

    <Ins>            Toggle insert/overwrite mode.  When you have a large
                     cursor showing you are in insert mode.

    <Ctrl-R>
    <Ctrl-Q><L>      Restore the line to original contents before any
                     editing was done.




                                         42                          09-01-91



 TurboTerm 2.0                 Program Reference

    <Ctrl-P>         Place the line editor in Ctrl-character mode.  When
                     <Ctrl-P> is pressed, the line editor displays a large
                     cursor which signifies that the next character typed
                     will be unconditionally added to the line.  Even
                     control characters such as a carriage returns may be
                     inserted in the edited line.  When a valid control
                     character is entered, the character will be displayed
                     as an uppercase representation of the control
                     character typed.  (for example, a Ctrl-M would show
                     as a capital 'M'.)



    Write text    <Alt-W>

    This command gives the ability to "write" some or all of the
    scrollback contents to a disk file, or copy it into the TurboTerm
    Clipboard.  If lines are currently marked in the scrollback buffer,
    then this command will only effect those marked lines.  If no marked
    lines are present, the entire contents of the scrollback buffer will
    be copied.  Upon completion of writing, all marked text will be
    unmarked.  If you are writing the text to a disk file and the default
    scrollback filename already exists, you will be prompted to overwrite,
    append or create a new file.  Attempting  to copy more text into the
    clipboard than the clipboard can hold will cause an error message to
    be displayed, and the clipboard will only contain the text that it was
    able to hold.


    Exiting TurboTerm     <Alt-X>

    To exit TurboTerm and end your telecommunications session, type
    <Alt-X>.  TurboTerm will close all open log files and exit to DOS.  If
    TurboTerm senses that you are still online, it will prompt you
    whether it should also hang up the modem prior to exiting.


    Terminal emulation    <Alt-Y>

    Setting your terminal emulation in TurboTerm is done by typing
    <Alt-Y>.  You will then be allowed to choose the emulation you wish
    TurboTerm to use.  A complete discussion of the available terminal
    emulations is found in the section of this manual dealing with the
    TTSetup configuration utility.   When changing terminal emulation, the
    screen is automatically cleared and the cursor placed in the lower
    left corner of the terminal window.  Note that you will be unable to
    choose ANSI emulation while in buffered mode.


    Online help    <Alt-Z>

    A brief chart of TurboTerm's function keys can be called up from
    within the terminal session by typing <Alt-Z>.






 09-01-91                                43



 TurboTerm 2.0                 Program Reference

    Send password     <Alt-F1>

    TurboTerm attempts to make logging on without a script as simple as
    possible.  Within the first two minutes of connection to a remote
    system, you may use the <Alt-F1> key to send the password defined in
    the dialing directory.  After two minutes have elapsed, TurboTerm
    zeroes out the password field to prevent accidentally sending your
    password at an inopportune time.


    Configure TurboTerm     <Alt-F2>

    While inside TurboTerm, it is possible to switch directly into the
    TTSetup configuration utility, using the <Alt-F2> keystroke.  All of
    the configuration options may be changed while executing TTSetup in
    this manner, but some options (mostly those that deal with your
    current connection parameters) will not take effect until after you've
    exited and re-entered TurboTerm.


    Delete scrollback    <Alt-F4>

    When you no longer need the contents of the scrollback buffer, or you
    need more free memory to shell to a program, you can delete the
    contents of scrollback by typing <Alt-F4>.  When you choose to delete
    scrollback, you will be asked to confirm your action.  If you choose
    yes, the scrollback window will be removed from the screen and the
    scrollback buffer will be cleared.


    TurboTerm Clipboard     <Alt-F5>

    To enter the TurboTerm Clipboard, press <Alt-F5>.  The TurboTerm
    clipboard is a WordStar based editor that allows cut and paste
    operations to and from the terminal session.  For a complete
    description on utilization of the TurboTerm Clipboard, refer to
    Appendix D.


    Send clipboard contents   <Alt-F6>

    To send (or "paste") the contents of the clipboard to the terminal
    session, press <Alt-F6>.   A few examples of clipboard usage are given
    in Appendix D.


    *UPLOAD clipboard    <Alt-F7>

    To *UPLOAD the contents of the clipboard to the GEMail editor, press
    <Alt-F7>.  An example of this function is given in Appendix D.









                                         44                          09-01-91



 TurboTerm 2.0                 Program Reference

    Resize scrollback window   <Ctrl-PgUp> or <Ctrl-PgDn>

    Resizing the scrollback window is NOT allowed in ANSI emulation.  In
    any other terminal emulation, you may resize the scrollback window to
    suit your needs.  The scrollback window can be from 3 lines to 18
    lines in size.  <Ctrl-PgUp> shrinks the size of the scrollback
    window by one line, and <Ctrl-PgDn> enlarges the scrollback window by
    one line.  The window size will remain in effect for the remainder of
    the terminal session, or until changed again.


    Clear scrollback window    <ESC>

    To remove the scrollback window and restore the normal terminal
    screen, press <ESC>.   The contents of the screen under the scrollback
    window will be automatically restored.


    Enter scrollback    <Up Arrow>

    To display the scrollback window while in the terminal, press the
    <Up Arrow> key.  In ANSI emulation, the scrollback window will be
    a full screen window, and cannot be resized.  In the other emulations,
    the window size is determined by the corresponding parameter in the
    configuration file, and the terminal screen will remain active while
    the window is displayed.

































 09-01-91                                45



 TurboTerm 2.0                    Appendix A            Setting Up a Ram Disk


       VDISK.SYS: [DOS 3.3]

       The VDISK.SYS file is a device driver that simulates a disk drive
       by using a portion of your computer's memory as the storage medium.
       These simulated disks are called virtual disks.  If you have an AT
       class computer, you can use the extended memory as one (or more)
       virtual disks.  If you have EMS memory on any class machine the
       same also applies.  Otherwise, virtual disks are located in low
       memory. As such, owners of PC or XT classes of computers with no
       EMS memory would see very little benefit to operating a virtual
       disk on their machine for use with TurboTerm -- the space it would
       occupy in standard DOS memory would, more than likely, leave so
       little available memory that you would not be able to run
       TurboTerm.  PC and XT users without EMS memory should therefore
       specify an actual disk device for their swap path -- it's slower
       than a virtual disk, but nonetheless effective for our use.  For
       those of you unfamiliar with installing virtual disks, refer to
       your DOS manual for a complete overview.  For our purposes, I'll
       show you how I have my system configured, and briefly outline what
       we consider to be the minimum suggested VDISK configuration.

       In my CONFIG.SYS file, I have the following line:

            DEVICE=C:\DOS\VDISK.SYS 1408 128 512 /E

       This installs a 1.4Meg ramdisk in extended memory, with 128 byte
       sectors, and a maximum of 512 directory entries.  Another possible
       configuration, which should work on AT machines without a memory
       expansion board, is:

            DEVICE=C:\DOS\VDISK.SYS 400 512 64 /E

       This will install a 400K ramdisk in extended memory, with 512 byte
       sectors, and a maximum of 64 directory entries.  We recommend a
       virtual disk of at least 400K for use with TurboTerm. It will allow
       enough room to write out the temporary "swap file" to the virtual
       disk.  Once you've installed VDISK.SYS in your CONFIG.SYS file, as
       outlined above, you simply need to "tell" TurboTerm to use the
       virtual disk as storage for it's swap file.  Start TTSetup, and
       pick the "Other" menu item.  On the sub-menu, choose "Memory
       Options". Change the setting for Allow Swapping to "Yes", then edit
       the Swap Path to indicate the virtual drive. (DOS assigns the next
       available drive letter to the virtual disk when it's installed, and
       tells you what drive letter has been assigned when you boot your
       computer.) That's it!  You now have TurboTerm set up to "swap out"
       rather than "shell out" when performing user shells, external
       protocols, and the <Alt-O> Shell/Swap-to-DOS option.











                                         46                          09-01-91



 TurboTerm 2.0                    Appendix A            Setting Up a Ram Disk


       RAMDRIVE.SYS:  [DOS 4.0/5.0]

       The setup of RAMDRIVE.SYS is virtually identical to the setup of
       VDISK.SYS with the exception of the name.  Read the section above
       on the use of VDISK, and substitute RAMDRIVE.SYS where VDISK.SYS is
       mentioned.  RAMDRIVE does not need the sector size nor the number
       of entries parameter, and they can be left out if desired.  On
       Scott's computer he has his RAMDRIVE setup as follows:

       In his CONFIG.SYS file is the following line:

           DEVICE=C:\DOS\RAMDRIVE.SYS 400 /E

       This instructs RAMDRIVE to create a 400k disk drive in extended
       memory.



       NON EMS 4.0 compliant EMS cards/drivers

       If TurboTerm is having problems accessing your EMS memory correctly
       then using one of the above solutions might be helpful.  Both
       RAMDRIVE.SYS, and VDISK.SYS have the ability to use EMS memory. If
       you wish to try RAMDRIVE, or VDISK with your EMS card then
       substitute the /E in the above examples with a /A

































 09-01-91                                47



 TurboTerm 2.0                    Appendix B                       Usage Logs


    The usage log is a feature which allows you to track your usage of a
    given system, and what you did while on that system.  The usage log
    keeps tracks of major events that occur while using TurboTerm, and
    logs the date and time of each event.  Usage logs are useful when you
    wish to keep track of your system usage for a given pay system.  This
    will allow you to closely verify your bill from the host system.  We
    at Keypunch Labs use it to verify our GEnie bill.  The usage log has
    two modes of operation.  (Verbose and Brief)  In brief mode only
    connects and disconnects will be logged in your usage log file. In
    verbose mode your usage logs will become slightly larger, but much
    more information can be learned from it.  A system directly dialed
    from your dialing directory can have its associated usage tracked. The
    are two way to track a give systems usage. You can turn auto log usage
    on, and all remote calling will be tracked by TurboTerm.  With this
    method all the information will be stored in the same file defined as
    the default usage filename.  This method is highly useful if you need
    to track all remote dialing.  The second method is to specify in each
    dialing directory entry, only those entries to have a usage file.
    This method allows tracking of system usage for only the systems which
    are most important to you.

    Verbose usage logs log the following:

         - All connections made to remote system via use of the dialing
           directory. This includes manual dials, and dials from a
           particular entry.

         - All disconnections from a remote system, including manual
         hang-ups.

         - The number of dialing attempts prior to connecting.

         - The start of all scripts.

         - The completion of all scripts.

         - Any scripts that were aborted.

         - Renaming of any capture logs done inside a script.

         - Any COMMENT command found in a script.

         - The completion of all file uploads and downloads with the CPS
           transfer rate attached.

         - Any failed file transfers.

         - Completion of clipboard Sends, and *UPLOAD's.

         - Aborted or failed clipboard Sends, and *UPLOAD's.

         - The name of all programs you shelled to.

         - The starting/stopping of all capture logs.




                                         48                          09-01-91



 TurboTerm 2.0                    Appendix B                       Usage Logs

    A typical verbose usage log would look something like this:

     08/01 20:26 ** Connected to: GEnie.  @385-3268
     08/01 20:26    Connected after 1 dial attempt(s).
     08/01 20:26    Started script: GENIE.SCR
     08/07 20:26  * You escaped from script
     08/01 20:26    Completed script: GENIE.SCR
     08/01 20:28    Shelled to: TTSETUP.EXE
     08/01 20:29    Zmodem receive aborted C:\TT\TRANS\TT106.EXE
     08/01 20:33    Zmodem receive C:\TT\TRANS\TT106.EXE Cps: 226
     08/01 20:45    XmodemCRC transmit C:\TT\BLANK-IT.COM Cps: 156
     08:01 20:45    Start log: TT.LOG
     08/01 20:46    Sent clipboard.
     08/01 20:49    *UPLOAD of clipboard.
     08/01 21:55    Close log: TT.LOG
     08/01 21:00    Shelled to: C:\SW2\SW2.BAT
     08/01 22:30  * You hung up on GEnie
     08/01 22:30 ** Disconnected from: Genie.  Time Connected: 01:58:21


    Brief usage logs log the following:

    (All entries will be preceded with a date and time stamp.)

         - All connections made to remote system via use of the dialing
           directory. This includes manual dials, and dials from a
           particular entry.

         - All disconnections from a remote system, including manual
         hang-ups.

    A typical brief usage log would look something like this:

     07/17 15:34 ** Connected to: GEnie.  @555-1212
     07/17 15:39 ** Disconnected from: GEnie. Time connected: 00:04:48
     07/19 16:03 ** Connected to: GEnie.  @555-1212
     07/19 16:07 ** Disconnected from: GEnie. Time connected: 00:03:38
     07/20 19:06 ** Connected to: GEnie.  @555-1212
     07/20 19:08 ** Disconnected from: GEnie. Time connected: 00:01:46
     08/01 19:09 ** Connected to: GEnie.  @555-1212
     08/01 19:11 ** Disconnected from: GEnie. Time connected: 00:02:31
     08/15 19:13 ** Connected to: GEnie.  @555-1212
     08/15 19:14 ** Disconnected from: GEnie. Time connected: 00:01:06
















 09-01-91                                49



 TurboTerm 2.0                    Appendix C                  Script Commands


    TurboTerm has the ability to automate many online tasks through the
    use of its interpreted script language.  While the summary that
    follows is hardly a compendium on the subject, combined with the
    sample scripts provided, you should be able to create a script to suit
    your specific needs.


    SEND <string>           - sends the specified string, with an appended
                              carriage return and linefeed.  The string
                              should be surrounded by quote marks (").

    TRANSMIT <string>       - sends the specified string, without
                              appending a carriage return and linefeed.
                              The string should be surrounded by quote
                              marks (").

    LOG <ON/OFF>            - activates or deactivates the currently named
                              capture log.

    GOTO <label>            - branches program control to the specified
                              label.  The named label must exist in the
                              current script.  A label is defined by
                              placing the associated keyword, preceded by
                              a colon, in the left column.

    GOSUB <label>           - branches to subroutine at the specified
                              label.

    RETURN                  - returns program control to the line
                              following that from which the current
                              subroutine was called.

    TIMEOUT <value>         - sets a default TIMEOUT value for the script.
                              If defined, it is not necessary to
                              explicitly specify a TIMEOUT value in
                              subsequent WAITFOR commands.

    WAIT <value>            - suspends script processing for <value>
                              seconds.

    BEEP <ONE/TWO>          - beeps the local speaker.

    TONE <freq> <duration>  - emits a tone of the specified frequency for
                              the specified duration.  The frequency is
                              supplied in Hertz, and the duration in
                              1/100's of a second.

    END                     - halts TurboTerm script processing.

    STOP                    - same as END.

    EXIT_TT                 - halts TurboTerm script processing and exits
                              the TurboTerm session.  If online, DTR will
                              be lowered to terminate the connection.  Any
                              open log files are automatically closed.



                                         50                          09-01-91



 TurboTerm 2.0                    Appendix C                  Script Commands

    UPLOAD<type> <fname>    - initiates a file transfer from TurboTerm to
                              the remote system.

    DOWNLOAD<type> <fname>  - initiates a file transfer to TurboTerm from
                              the remote system.

          where  <type> =        X : Xmodem-CRC
                                 1 : Xmodem-1K
                                 Y : Ymodem (Batch)
                                 G : Ymodem-G (Batch)
                                 Z : Zmodem (Batch)
                                 K : Kermit (Batch)
                                 A : ASCII  (upload only)

                              Note that there is no space between the
                              UPLOAD or DOWNLOAD keyword and the
                              associated transfer type.  <fname> should
                              refer to an existing filename or valid DOS
                              wildcard in the defined upload or download
                              directory.

    WRITE <string>          - writes the specified string to the local
                              screen (NOT transmitted).  The string should
                              be surrounded by quote marks (").

    WAITFOR <string> <command> [timeout]

                            - waits for the specified string to be
                              received, then performs the command
                              specified.  The timeout parameter does not
                              need to be specified if a previous TIMEOUT
                              command exists in the script.

    WHEN <number> <string> GOTO/GOSUB/SEND/TRANSMIT

                            - processes incoming text, waiting for a
                              particular string to be received.  This
                              procedure works in conjunction with an
                              existing (and pending) WAITFOR statement.
                              Up to ten WHEN statements may be active at
                              any given time.

    WHEND <number>          - cancels processing of the specified WHEN
                              statement.

    DUPLEX <HALF/FULL>      - sets TurboTerm's duplex setting to half or
                              full.

    LOGNAME <fspec>         - sets the name of the current TurboTerm
                              capture file.  No drive/directory is
                              supported - the log of the specified name
                              will be written to the default LOG
                              directory, as defined in the configuration
                              file.





 09-01-91                                51



 TurboTerm 2.0                    Appendix C                  Script Commands

    STAMPLOG [string]       - writes the specified string to the current
                              capture log (if active).  If no string is
                              specified, TurboTerm will write it's
                              default time/datestamp to the file.  The
                              string (if specified) must be surrounded by
                              quote marks (").

    COMMENT <string>        - writes the specified string to the current
                              usage log (if active).  The string must be
                              surrounded by quote marks (").


    Any line in a script file beginning with a semi-colon (;) is
    considered a comment line, and will not be processed or interpreted.
    Note that all TurboTerm script keywords must be flush to the left
    margin for proper interpretation.

    Examples:

    ; TurboTerm! v2.0 Script file
    ;
    WAIT 2
    SEND "HHH"
    DUPLEX FULL
    WAITFOR "U#=" SEND "{PASSWORD}" TIMEOUT 10
    DUPLEX HALF
    BEEP ONE
    WRITE "Connected to GEnie"
    END
    ;

    The above script will logon to GEnie.  Note that, for proper
    operation, your user id and password should be defined in the
    associated dialing entry. (ie: xyz12345,password )

    The following script shows the ability to write complex applications
    with TurboTerm's scripting language.  This script will capture any
    waiting GEMail to a file called EMAIL.TXT, capture a list of new files
    in the IBM RoundTable to a file called IBMFILES.NEW, and then capture
    all new messages in the LiveWire Bulletin Board to a file called
    LIVEWIRE.TXT.  After completion of this script, TurboTerm will exit
    back to the DOS prompt.  On my system, I regularly run a similar
    script on a daily basis, by specifying it as the attached script for a
    special GEnie entry in my phone directory.  I then invoke TurboTerm
    from a batch file, using "TT @5" to automatically dial entry number
    five upon startup.













                                         52                          09-01-91



 TurboTerm 2.0                    Appendix C                  Script Commands

    ;  TurboTerm! v2.0 Script File
    ;
    ;  Script : GEMAIL.SCR  - captures waiting GEMail.
    ;  Created: 08/17/91 20:40
    ;  Author : Brian S. Dunworth
    ;
    ;  This script makes use of several of TurboTerm's script commands.
    ;
    ;  *Note:  The COMMENT lines will write comments into the current
    ;          USAGE log if it is active during the connect.  If the
    ;          USAGE log is inactive, the line will be ignored.
    ;
    ;
    ;------------------------------------------------------------------
    ;
    ; first, set up a conditional statement to check for our EMail...
    ;
    WHEN 1 "You have" GOTO MAIL
    ;
    ;  ..if we have letters waiting, we'll execute the MAIL procedure.
    ;
    ;
    ; -------------------------------
    ;  Logon
    ; -------------------------------
    WAIT 2
    SEND "HHH"
    ;
    ; Here, we switch the duplex, so that anyone looking over
    ; our shoulder won't see our password being entered.
    ;
    DUPLEX FULL
    WAITFOR "U#=" SEND "{PASSWORD}" TIMEOUT 10
    DUPLEX HALF
    ;
    ; -------------------------------
    ;  GEMail Main Procedure
    ; -------------------------------
    ;
    WAITFOR "tinue?" SEND "{Enter}" TIMEOUT 60
    ;
    ; if we get here, there was no mail waiting, so deactivate the
    ; conditional...
    ;
    WHEND 1
    ;
    ;
    ; Capture list of new files
    ;
    :BOARDS
    WAITFOR "P 1?" SEND "m615;3" TIMEOUT 60
    WRITE "Capturing IBM RT new files list"
    LOGNAME IBMFILES.NEW
    COMMENT "Capturing IBM RT file listing"
    WAITFOR "Library?" SEND "11" TIMEOUT 60
    LOG ON
    WAITFOR "Library?" GOSUB DONELOG TIMEOUT 32000
    SEND "exit"

 09-01-91                                53



 TurboTerm 2.0                    Appendix C                  Script Commands

    ;
    ; Capture messages
    ;
    WAITFOR "P 615?" SEND "m400;7" TIMEOUT 60
    WRITE "Scanning LiveWire Board"
    WAITFOR "1 ?" SEND "scr 0" TIMEOUT 100
    WAITFOR "1 ?" SEND "bro nor" TIMEOUT 30
    LOGNAME LIVEWIRE.TXT
    COMMENT "Capturing LiveWire BB Messages"
    LOG ON
    WAITFOR "1 ?" GOSUB DONELOG TIMEOUT 32000
    ;
    ; Log off GEnie and exit TurboTerm
    ;
    SEND "exit"
    WAITFOR "P 400?" SEND "bye" TIMEOUT 90
    ;
    WAITFOR "NO CARRIER" GOTO BYEBYE TIMEOUT 100
    ;
    END
    ;
    ;
    ; -------------------------------
    ;  GEMail Script   Subroutines
    ; -------------------------------
    ;
    ; Letters waiting
    :MAIL
    ;
    ;  If we got here, there was EMail waiting for us...
    ;
    WHEND 1
    ;
    WRITE "Capturing waiting EMail"
    WAITFOR "tinue?" SEND "m200;9" TIMEOUT 60
    WAITFOR "Command?" SEND "list" TIMEOUT 60
    LOGNAME EMAIL.TXT
    COMMENT "Capturing EMail"
    LOG ON
    WAITFOR "Command?" GOSUB DONELOG TIMEOUT 32000
    SEND "exi"
    WAITFOR "P 200?" SEND "top" TIMEOUT 15
    GOTO BOARDS
    ;
    :DONELOG
    ;  this small subroutine does nothing more than turn OFF the current
    ;  log file.  It is called a few times during this script...
    ;
    LOG OFF
    RETURN
    ;
    :BYEBYE
    ; This procedure will exit TurboTerm, and return to the DOS prompt.
    ;
    EXIT_TT
    ;



                                         54                          09-01-91



 TurboTerm 2.0                    Appendix D              TurboTerm Clipboard


    The TurboTerm clipboard functions as a scratch pad, a text editor, and
    a cut-and-paste tool for the telecommunications session.  The
    TurboTerm editor functions as a basic text editor of limited size, and
    is not meant to replace your favorite word processor.  The commands in
    the editor follow the WordStar conventions, and are described below.
    You will find that TurboTerm's clipboard has many useful functions on
    GEnie, CompuServe, and any other BBS that you happen to frequent.  The
    ability to cut-and-paste from your telecommunications session makes
    quoting messages a snap!  The discussion on the TurboTerm clipboard
    will be broken down into four sections.  The first will be a general
    discussion of the features in the clipboard, and what the terminology
    means.  The second will cover the basic command set governing editing
    of text in the clipboard.  The third will discuss how to cut and paste
    information to and from the clipboard and telecom session.  The fourth
    section is a walk through of how to use the TurboTerm clipboard to
    quote a message while online to GEnie.

    The maximum document size that the clipboard can handle is 10,000
    characters.  This means that typical files, less than 300 lines, will
    fit; anything larger will not.  TurboTerm's clipboard is not designed
    to take the place of your favorite text editor, it is designed to
    allow quick and effecient text editing without leaving your terminal
    session.  The percentage number shown on the clipboard status line
    indicates the percentage of clipboard workspace that is full.

    Word Wrap:

    Word wrap is a function which controls whether the editor will
    automatically wrap any typed text to the next line when the right
    margin is reached.  When word wrap is turned off, text will not
    automatically be wrapped to the next line.

    Indent mode:

    Indent mode controls whether the editor will automatically place you
    at the same column position as the previous line, when the line wraps
    or an <Enter> is pressed.  If word wrap is off, all new lines will
    begin at the left margin.

    Insert mode:

    Insert mode controls whether characters you type will be inserted into
    the text and the charters to the left be pushed to the right, or new
    characters will overwrite existing text.

    Right Margin:

    The clipboard right margin is configurable from 5 to 125 characters in
    length.  The default value is 60 characters.  This value is used to
    determine how the clipboard will wrap words when you are entering
    text, or during a reformat.

    Block handling:

    Blocks of text in the clipboard are handled on a line-by-line basis.
    This means that marking blocks for moving, copying, inserting, or
    deleting can only be done using entire lines of text.

 09-01-91                                55



 TurboTerm 2.0                    Appendix D              TurboTerm Clipboard


    Timer:

    While editing in the clipboard, keystrokes are NOT echoed to the
    modem.  Since many host systems will "time out" when you are not
    actively doing something on the system, TurboTerm has a built-in
    timer/warning mechanism.  The timer will always display in the bottom
    right hand corner of the screen, indicating the number of minutes and
    seconds you have been editing in the clipboard. If you have the
    warning time set in the configuration file to any value other than 0
    minutes, TurboTerm will sound a warning whistle when the specified
    time is reached.  This is a handy feature to prevent you from
    accidently getting disconnected from a host system when you have been
    idle too long.

    Line and Column postion:

    The clipboard status line will continually update the current column
    and line number of the cursor positon.

    Clipboard commands:

    The clipboard command set is a subset of the WordStar commands.  While
    in the clipboard, a brief help menu is available by typing <F1>.  The
    following chart outlines the various commands available:


    Command          Function
    -------          ---------

    <Right Arrow>
    <Ctrl-D>         Moves the cursor right one space.

    <Left Arrow>
    <Crtl-I>         Moves the cursor left one space.

    <Ctrl-Left>
    <Ctrl-A>         Move the cursor left one word. If the cursor is at
                     the beginning of a line, it is moved to the end of
                     the previous line.

    <Ctrl-Right>
    <Ctrl-F>         Move the cursor right one word. If the cursor is at
                     the end of a line, it is moved to the beginning of
                     the following line.

    <Home>
    <Ctrl-Q><S>      Move the cursor to the beginning of the line.

    <End>
    <Ctrl-Q><D>      Move the cursor to end of the line.

    <Up Arrow>
    <Ctrl-E>         Move the cursor up one line.

    <Down Arrow>
    <Ctrl-X>         Move the cursor down one line.


                                         56                          09-01-91



 TurboTerm 2.0                    Appendix D              TurboTerm Clipboard

    <Ctrl-W>         Set your right margin and reformat the clipboard.

    <Ctrl-Z>         Scroll display down one line.

    <PgUp>
    <Ctrl-R>         Scroll display up one page.

    <PgDn>
    <Ctrl-C>         Scroll display down one page.

    <Ctrl-Home>
    <Ctrl-Q><E>      Move cursor to top of edit window.

    <Ctrl-End>
    <Ctrl-Q><X>      Move cursor to bottom of edit window.

    <Ctrl-PgUp>
    <Ctrl-Q><R>      Move cursor to beginning of file.

    <Ctrl-PgDn>
    <Ctrl-Q><C>      Move cursor to end of file.

    <Del>
    <Ctrl-G>         Delete character at cursor.

    <Bksp>
    <Ctrl-H>
    <Ctrl-Bksp>      Delete character to left of cursor. If the cursor is
                     at the beginning of a line, the line will be joined
                     with the previous line.

    <Ctrl-Y>         Delete the current line.

    <Ctrl-Q><Y>      Delete from cursor to end of line.

    <Ctrl-T>         Delete word to right of cursor. If the cursor is at
                     end of a line, the following line is joined with the
                     current line.

    <Enter>
    <Ctrl-M>         Start a new line.

    <Tab>
    <Ctrl-I>         Move the cursor to the next tab stop. If insert mode
                     is on, any text to the right of the cursor is moved
                     to the right of the tab stop.

    <Ctrl-P>         Insert control character.  For example, to insert a
                     <Ctrl-G>, you would enter <Ctrl-P><Ctrl-G>.  Control
                     characters are displayed as uppercase characters.

    <Ins>
    <Ctrl-V>         Toggle insert mode on and off. A fat cursor indicates
                     insert mode, a thin cursor indicates overtype mode.





 09-01-91                                57



 TurboTerm 2.0                    Appendix D              TurboTerm Clipboard

    <Ctrl-O><I>      Toggle auto-indent mode on or off. In auto-indent
                     mode, pressing <Enter> while in insert mode will
                     cause the newly typed line to have the same
                     indentation level as the previous line.  Auto-indent
                     mode also affects the way text is formatted when word
                     wrap occurs.  The new line will have the same
                     indentation level as the previous line, and hence the
                     behavior of the reformatting commands (<CtrlB> and
                     <AltR>).

    <Ctrl-O><W>      Toggle word wrap on and off. When word wrap is on,
                     any attempt to insert or append text beyond the right
                     margin will cause a new line to be inserted following
                     the current line and all words that are at least
                     partially beyond the right margin will be moved to
                     the new line.

    <Ctrl-B>         Reformat the current paragraph.

    <Alt-R>          Reformat the entire clipboard. Use this command with
                     caution.

    <Ctrl-Q><L>      Restore original contents of the current line.

    Block commands:

    <Ctrl-K><R>      Read a block of text into the clipboard at the
                     current line position.

    <Ctrl-K><W>      Write a marked block af text to a disk file.

    <Ctrl-K><B>      Mark the begining line of a block of text.

    <Ctrl-K><K>      Mark the ending line of a block of text.

    <Ctrl-K><V>      Move a block of text.

    <Ctrl-K><C>      Copy a block of text.

    <Ctrl-K><Y>      Delete a block of text.

    <Ctrl-K><H>      Unmark a block of text.


    Other commands:

    <F1>             Display a help screen, listing the most often used
                     keystrokes.

    <F2>             Load a new file into the clipboard at the current
                     cursor position.

    <F3>
    <Ctrl-K><S>      Save the clipboard contents to a file.


    <Alt-C>          Clear the contents of the current clipboard.


                                         58                          09-01-91



 TurboTerm 2.0                    Appendix D              TurboTerm Clipboard


    Entering and exiting the clipboard:

    <Alt-F5>         Enter the clipboard.

    <Esc>
    <Ctrl-Break>     Exit the clipboard.


    Clipboard cutting and pasting:

    Cutting and pasting from the clipboard is a simple task, and will
    become second nature with just a little practice.

    To paste, we mean to take the contents of the clipboard and copy them
    to the terminal session as though you had typed them in manually.
    There are two ways to "paste" clipboard text; copying and *UPLOADing.
    Copying is used in applications where you want it to simulate manually
    typed text and *UPLOADing is a special GEnie fuction used for
    composing EMail or bulletin board messages.  Accessing both of these
    functions is done from within the terminal session, and not while in
    the clipboard.

    <Alt-F6>         Copy the contents of the clipboard to the terminal
                     seesion, using the delays stated for ASCII line and
                     character pacing set in the configuration file.  If a
                     prefix is active then any line copied in this manner
                     will have the prefix string added.

    <Alt-F7>         *UPLOAD the contents of the clipboard to the GEnie
                     mail editor.  This command isssues a *UPLOAD command
                     to the GEnie editor, waits for the "READY FOR INPUT"
                     command, and then begins sending the text using the
                     delays specified for ASCII line and character pacing
                     in the configuration file.  At the completion of the
                     *UPLOAD, a Ctrl-C is sent to tell GEnie that the
                     *UPLOAD is complete.  If a prefix is active then any
                     line *UPLOADed will have the prefix added.  Note that
                     for this function to work properly, you must have
                     Ctrl-C (ASCII 03) set as your "break" character on
                     GEnie.


    Getting text into then clipboard:

    There are two ways to get text into the clipboard; reading from a
    disk file and cutting it from the scrollback buffer.  Use the commands
    mentioned above to read from a disk file.  The following discussion
    will describe how, using scrollback, you can get text into the
    clipboard.









 09-01-91                                59



 TurboTerm 2.0                    Appendix D              TurboTerm Clipboard

    When scrollback is displayed on the screen, you will notice that one
    of the choices on the scroll bar is <Alt-W>.  <Alt-W> allows you to
    copy the text that is currently in scrollback to a file or to the
    clipboard.  If text is marked in the scrollback then only the marked
    text will be copied; if no marks are present then the entire contents
    of the clipboard will be copied.  If you attempt to copy more text
    into the clipboard than the clipboard can hold, the clipboard will
    truncate it at its limit.  The series of commands to move text from
    scrollback to the clipboard is <Alt-W><C>.


    Marking text:

    To mark text in scrollback, simply place the first line that you wish
    to mark on the bottom line of the scrollback window and press <Alt-M>.
    Then, place the bottom of the text you wish to mark on the bottom line
    of the scrollback window, and again press <Alt-M>.  TurboTerm will
    mark all text in the scrollback buffer between those two lines.  If
    you wish to copy that information to the clipboard, use the <Alt-W><C>
    command, or write it to a file using the <Alt-W><S> command.


    Sample quoting in the clipboard:

    Suppose you just received a letter from a GEnie subscriber, and in his
    message he asked two or three questions of you.  You could just do a
    typical GEnie mail reply, and answer the questions.   By the time the
    person who sent the original message receives the reply, he may have
    forgotten his message, and your reply may be meaningless.  This
    problem would be alleviated by quoting relevant portions of the
    original message in your reply, so that both the question and the
    answer were in the response.  To illustrate how quoting in TurboTerm
    might be handled, let's walk through a sample session, and see how the
    process works:

        Brian,
        Here is a copy of my CONFIG.SYS file that you asked for.  I hope
        that this will help you determine the reason TurboTerm does not
        work with my modem connected to COM2 at 2400 baud.  Thanks again
        for all your help!!

        SHELL=C:\DOS\COMMAND.COM /P
        DEVICE=C:\DOS\ANSI.SYS
        DEVICE=C:\DOS\RAMDRIVE.SYS 400 /E
        DEVICE=C:\DOS\SMARTDRV.SYS 1024 512
        DEVICE=C:\UTILS\MOUSE.SYS COM2
        FILES=20
        BUFFERS=20


        That's it Brian, my CONFIG.SYS file.  I truly hope you can get
        TurboTerm working for me since I run it on my machine at work, and
        I LOVE it.  Thanks...

                                             Tom

        =END=


                                         60                          09-01-91



 TurboTerm 2.0                    Appendix D              TurboTerm Clipboard


    Above is the letter from Tom, who is having a bit of difficulty using
    TurboTerm, and would like some assistance from Brian.  Brian, being
    the superb truobleshooter that he is, notices that Tom's mouse driver
    is on COM2, as is his modem.  Let's reply to the message.

    This is message one in Brian's mail queue, so he types "REPLY 1" at
    the GEMail command prompt. This tells GEnie that Brian is going to
    reply to message 1 in his mail queue.  GEnie responds with a short
    message and another prompt:

        1>

    First, we type in a short opening, like:

        1> Hi Tom,
        2> I received your mail today, and think I have found the problem.
        3>
        4>


    The first thing we want to do is thank Tom for his enthusiasm, and for
    sending us a copy of his CONFIG.SYS file.  We pull up scollback using
    <UpArrow>, and mark the first three lines of Tom's letter using the
    <Alt-M> command.  We then want those lines copied to our clipboard so
    we use the <Alt-W><C> command.

    A typical quoted message uses some form of identifier to show the
    quoted portions.  A typical identifier would be " > " (without the
    quote marks).  Knowing that, let's set our prefix to that string.
    Type <Alt-A><E>, and type <space><greater-than><space> in the prefix
    string.

    Tom's letter to Brian is in 80 colum format, and if we were to add the
    " > " prefix to each line, the text would wrap around to the next line
    and generally make a mess of things.  So, we should reformat Tom's
    letter (in our clipboard) to aproximately 60 characters in length.
    So, we enter the clipboard by typing <Alt-F5>, and see the text copied
    there from the scrollback buffer just seconds ago.  Now, we type
    <Ctrl-W>, and set the new right margin at 60.  TurboTerm will reformat
    the text in the clipboard, so that no line exceeds 60 characters in
    length.

    Now we are ready to quote his text.  We exit the clipboard and type
    <Alt-F7>.  At this point, we're prompted whether we wish to *UPLOAD
    the clipboard the clipboard contents.  We do, so we select <Y>es.
    TurboTerm issues a *UPLOAD command to GEnie, and waits for GEnie to
    respond with "READY FOR INPUT".  TurboTerm will then transmit the
    contents of the clipboard with the attached prefix and send a Ctrl-C
    at the completion of the *UPLOAD to tell GEnie that our upload is
    complete.  When GEnie has responded to the Ctrl-C, it will return us
    to the line editor.  Here is where we will thank him for his note.







 09-01-91                                61



 TurboTerm 2.0                    Appendix D              TurboTerm Clipboard

        9>
       10> Thanks for sending me a copy of your CONFIG.SYS file.  It
       11> enabled me to find the problem, and I'm sure that this will
       12> fix it.  In your CONFIG.SYS file, you had:
       13> CONFIG.SYS file you said you had:
       14>

    Now, we'll quote the CONFIG.SYS file he sent us.  To do this, we need
    to first clear the contents of the clipboard by typing <Alt-F5> to
    enter the clipboard, and <Alt-C> to clear it.  Now we'll mark the
    entire CONFIG.SYS file in our scrollback buffer, and copy it to the
    clipboard.  Again, we type <Alt-F7> and wait for the completion of the
    *UPLOAD.

       20>
       21> ...the problem appears to be that your mouse is connected to
       22> COM2, according to your CONFIG.SYS file.  Obviously, this will
       23> prevent TurboTerm from running on COM2.  My suggestion is to
       24> connect your modem to COM1, and leave the mouse on COM2.  You
       25> might also put the mouse on COM1, and the modem on COM2.  The
       26> point is, you can't have both devices on the same port at the
       27> same time.
       28>
       29> If you need any further help, feel free to drop me a note.
       30> Again, thanks for your support and registration.
       31>
       32> See ya online!
       33> Brian
       34>

    Now that our reply is complete, let's review how it looks:

       34>*L

    GEnie will respond with:
























                                         62                          09-01-91



 TurboTerm 2.0                    Appendix D              TurboTerm Clipboard

        1  Hi Tom,
        2  I received your mail today, and think I have found the problem.
        3
        4   > Here is a copy of my CONFIG.SYS file that you asked for.  I
        5   > hope that this will help you determine the reason TurboTerm
        6   > does not work with my modem connected to COM2 at 2400 baud.
        7   > work with my modem connected to COM2 at 2400 baud.  Thanks
        8   > for all your help!!
        9
       10  Thanks for sending me a copy of your CONFIG.SYS file.  It
       11  enabled me to find the problem, and I'm sure that this will
       12  fix it.  In your CONFIG.SYS file, you had:
       13  CONFIG.SYS file you said you had:
       14
       13   > SHELL=C:\DOS\COMMAND.COM /P
       14   > DEVICE=C:\DOS\ANSI.SYS
       15   > DEVICE=C:\DOS\RAMDRIVE.SYS 400 /E
       16   > DEVICE=C:\DOS\SMARTDRV.SYS 1024 512
       17   > DEVICE=C:\UTILS\MOUSE.SYS COM2
       18   > FILES=20
       19   > BUFFERS=20
       20
       21  ...the problem appears to be that your mouse is connected to
       22  COM2, according to your CONFIG.SYS file.  Obviously, this will
       23  prevent TurboTerm from running on COM2.  My suggestion is to
       24  connect your modem to COM1, and leave the mouse on COM2.  You
       25  might also put the mouse on COM1, and the modem on COM2.  The
       26  point is, you can't have both devices on the same port at the
       27  same time.
       28
       29  If you need any further help, feel free to drop me a note.
       30  Again, thanks for your support and registration.
       31
       32  See ya online!
       33  Brian
       34

    Everything looks ok, so we send the message:

       34>*S

    Message 105687 sent to:  Tom.S

    Thats it!  We've completed a professional-style message quote!















 09-01-91                                63